com.amazonaws.services.kinesis.clientlibrary.interfaces

Interface ICheckpoint

public interface ICheckpoint

Interface for checkpoint trackers.

Method Summary

Methods

Modifier and Type	Method and Description
ExtendedSequenceNumber	getCheckpoint(java.lang.String shardId) Get the current checkpoint stored for the specified shard.
void	setCheckpoint(java.lang.String shardId, ExtendedSequenceNumber checkpointValue, java.lang.String concurrencyToken) Record a checkpoint for a shard (e.g.

Method Detail

setCheckpoint

void setCheckpoint(java.lang.String shardId,
                 ExtendedSequenceNumber checkpointValue,
                 java.lang.String concurrencyToken)
                   throws KinesisClientLibException

Record a checkpoint for a shard (e.g. sequence and subsequence numbers of last record processed by application). Upon failover, record processing is resumed from this point.

Parameters:

shardId - Checkpoint is specified for this shard.

checkpointValue - Value of the checkpoint (e.g. Kinesis sequence number and subsequence number)

concurrencyToken - Used with conditional writes to prevent stale updates (e.g. if there was a fail over to a different record processor, we don't want to overwrite it's checkpoint)

Throws:

KinesisClientLibException - Thrown if we were unable to save the checkpoint

getCheckpoint

ExtendedSequenceNumber getCheckpoint(java.lang.String shardId)
                                     throws KinesisClientLibException

Get the current checkpoint stored for the specified shard. Useful for checking that the parent shard has been completely processed before we start processing the child shard.

Parameters:

shardId - Current checkpoint for this shard is fetched

Returns:

Current checkpoint for this shard, null if there is no record for this shard.

Throws:

KinesisClientLibException - Thrown if we are unable to fetch the checkpoint