com.amazonaws.services.kinesis.multilang

Class MultiLangRecordProcessor

java.lang.Object

com.amazonaws.services.kinesis.multilang.MultiLangRecordProcessor

All Implemented Interfaces:

IRecordProcessor

public class MultiLangRecordProcessor
extends java.lang.Object
implements IRecordProcessor

A record processor that manages creating a child process that implements the multi language protocol and connecting that child process's input and outputs to a MultiLangProtocol object and calling the appropriate methods on that object when its corresponding initialize(java.lang.String), processRecords(java.util.List<Record>, com.amazonaws.services.kinesis.clientlibrary.interfaces.IRecordProcessorCheckpointer), and shutdown(com.amazonaws.services.kinesis.clientlibrary.interfaces.IRecordProcessorCheckpointer, com.amazonaws.services.kinesis.clientlibrary.types.ShutdownReason) methods are called.

Method Summary

Modifier and Type	Method and Description
void	initialize(java.lang.String shardIdToProcess) Invoked by the Amazon Kinesis Client Library before data records are delivered to the RecordProcessor instance (via processRecords).
void	processRecords(java.util.List<Record> records, IRecordProcessorCheckpointer checkpointer) Process data records.
void	shutdown(IRecordProcessorCheckpointer checkpointer, ShutdownReason reason) Invoked by the Amazon Kinesis Client Library to indicate it will no longer send data records to this RecordProcessor instance.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

initialize

public void initialize(java.lang.String shardIdToProcess)

Description copied from interface: IRecordProcessor

Invoked by the Amazon Kinesis Client Library before data records are delivered to the RecordProcessor instance (via processRecords).

Specified by:

initialize in interface IRecordProcessor

Parameters:

shardIdToProcess - The record processor will be responsible for processing records of this shard.

processRecords

public void processRecords(java.util.List<Record> records,
                           IRecordProcessorCheckpointer checkpointer)

Description copied from interface: IRecordProcessor

Process data records. The Amazon Kinesis Client Library will invoke this method to deliver data records to the application. Upon fail over, the new instance will get records with sequence number > checkpoint position for each partition key.

Specified by:

processRecords in interface IRecordProcessor

Parameters:

records - Data records to be processed

checkpointer - RecordProcessor should use this instance to checkpoint their progress.

shutdown

public void shutdown(IRecordProcessorCheckpointer checkpointer,
                     ShutdownReason reason)

Description copied from interface: IRecordProcessor

Invoked by the Amazon Kinesis Client Library to indicate it will no longer send data records to this RecordProcessor instance. The reason parameter indicates: a/ ShutdownReason.TERMINATE - The shard has been closed and there will not be any more records to process. The record processor should checkpoint (after doing any housekeeping) to acknowledge that it has successfully completed processing all records in this shard. b/ ShutdownReason.ZOMBIE: A fail over has occurred and a different record processor is (or will be) responsible for processing records.

Specified by:

shutdown in interface IRecordProcessor

Parameters:

checkpointer - RecordProcessor should use this instance to checkpoint.

reason - Reason for the shutdown (ShutdownReason.TERMINATE indicates the shard is closed and there are no more records to process. Shutdown.ZOMBIE indicates a fail over has occurred).