com.amazonaws.services.kinesis.clientlibrary.interfaces

Interface IRecordProcessorCheckpointer

public interface IRecordProcessorCheckpointer

Used by RecordProcessors when they want to checkpoint their progress. The Amazon Kinesis Client Library will pass an object implementing this interface to RecordProcessors, so they can checkpoint their progress.

Method Summary

Methods

Modifier and Type	Method and Description
void	checkpoint() This method will checkpoint the progress at the last data record that was delivered to the record processor.

Method Detail

checkpoint

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

This method will checkpoint the progress at the last data record that was delivered to the record processor. Upon fail over (after a successful checkpoint() call), the new/replacement RecordProcessor instance will receive data records whose sequenceNumber > checkpoint position (for each partition key). In steady state, applications should checkpoint periodically (e.g. once every 5 minutes). Calling this API too frequently can slow down the application (because it puts pressure on the underlying checkpoint storage layer).

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 RecordProcessor 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.