software.amazon.kinesis.processor

Interface PreparedCheckpointer

All Known Implementing Classes:

DoesNothingPreparedCheckpointer, ShardPreparedCheckpointer

public interface PreparedCheckpointer

Objects of this class are prepared to checkpoint at a specific sequence number. They use an RecordProcessorCheckpointer to do the actual checkpointing, so their checkpoint is subject to the same 'didn't go backwards' validation as a normal checkpoint.

Method Summary

Modifier and Type	Method and Description
void	checkpoint() This method will record a pending checkpoint.
ExtendedSequenceNumber	pendingCheckpoint()

Method Detail

pendingCheckpoint

ExtendedSequenceNumber pendingCheckpoint()

Returns:

sequence number of pending checkpoint

checkpoint

void checkpoint()
         throws KinesisClientLibDependencyException,
                InvalidStateException,
                ThrottlingException,
                ShutdownException,
                IllegalArgumentException

This method will record a pending checkpoint.

Throws:

ThrottlingException - Can't store checkpoint. Can be caused by checkpointing too frequently. Consider increasing the throughput/capacity of the checkpoint store or reducing checkpoint frequency.

ShutdownException - The record processor instance has been shutdown. Another instance may have started processing some of these records already. The application should abort processing via this ShardRecordProcessor instance.

InvalidStateException - Can't store checkpoint. Unable to store the checkpoint in the DynamoDB table (e.g. table doesn't exist).

KinesisClientLibDependencyException - Encountered an issue when storing the checkpoint. The application can backoff and retry.

IllegalArgumentException - The sequence number being checkpointed is invalid because it is out of range, i.e. it is smaller than the last check point value (prepared or committed), or larger than the greatest sequence number seen by the associated record processor.