com.amazonaws.services.kinesis.clientlibrary.proxies

Interface IKinesisProxy

All Known Subinterfaces:

IKinesisProxyExtended

All Known Implementing Classes:

KinesisProxy, MetricsCollectingKinesisProxyDecorator

public interface IKinesisProxy

Kinesis proxy interface. Operates on a single stream (set up at initialization).

Method Summary

Modifier and Type	Method and Description
GetRecordsResult	get(String shardIterator, int maxRecords) Get records from stream.
Set<String>	getAllShardIds() Fetch the shardIds of all shards in the stream.
String	getIterator(String shardId, String iteratorEnum, String sequenceNumber) Fetch a shard iterator from the specified position in the shard.
List<Shard>	getShardList() Fetch all the shards defined for the stream (e.g.
DescribeStreamResult	getStreamInfo(String startShardId) Fetch information about stream.
PutRecordResult	put(String sequenceNumberForOrdering, String explicitHashKey, String partitionKey, ByteBuffer data)

Method Detail

get

GetRecordsResult get(String shardIterator,
                     int maxRecords)
              throws ResourceNotFoundException,
                     InvalidArgumentException,
                     ExpiredIteratorException

Get records from stream.

Parameters:

shardIterator - Fetch data records using this shard iterator

maxRecords - Fetch at most this many records

Returns:

List of data records from Kinesis.

Throws:

InvalidArgumentException - Invalid input parameters

ResourceNotFoundException - The Kinesis stream or shard was not found

ExpiredIteratorException - The iterator has expired

getStreamInfo

DescribeStreamResult getStreamInfo(String startShardId)
                            throws ResourceNotFoundException

Fetch information about stream. Useful for fetching the list of shards in a stream.

Parameters:

startShardId - exclusive start shardId - used when paginating the list of shards.

Returns:

DescribeStreamOutput object containing a description of the stream.

Throws:

ResourceNotFoundException - The Kinesis stream was not found

getAllShardIds

Set<String> getAllShardIds()
                    throws ResourceNotFoundException

Fetch the shardIds of all shards in the stream.

Returns:

Set of all shardIds

Throws:

ResourceNotFoundException - If the specified Kinesis stream was not found

getShardList

List<Shard> getShardList()
                  throws ResourceNotFoundException

Fetch all the shards defined for the stream (e.g. obtained via calls to the DescribeStream API). This can be used to discover new shards and consume data from them.

Returns:

List of all shards in the Kinesis stream.

Throws:

ResourceNotFoundException - The Kinesis stream was not found.

getIterator

String getIterator(String shardId,
                   String iteratorEnum,
                   String sequenceNumber)
            throws ResourceNotFoundException,
                   InvalidArgumentException

Fetch a shard iterator from the specified position in the shard.

Parameters:

shardId - Shard id

iteratorEnum - one of: TRIM_HORIZON, LATEST, AT_SEQUENCE_NUMBER, AFTER_SEQUENCE_NUMBER

sequenceNumber - the sequence number - must be null unless iteratorEnum is AT_SEQUENCE_NUMBER or AFTER_SEQUENCE_NUMBER

Returns:

shard iterator which can be used to read data from Kinesis.

Throws:

ResourceNotFoundException - The Kinesis stream or shard was not found

InvalidArgumentException - Invalid input parameters

put

PutRecordResult put(String sequenceNumberForOrdering,
                    String explicitHashKey,
                    String partitionKey,
                    ByteBuffer data)
             throws ResourceNotFoundException,
                    InvalidArgumentException

Parameters:

sequenceNumberForOrdering - (optional) used for record ordering

explicitHashKey - optionally supplied transformation of partitionkey

partitionKey - for this record

data - payload

Returns:

PutRecordResult (contains the Kinesis sequence number of the record).

Throws:

ResourceNotFoundException - The Kinesis stream was not found.

InvalidArgumentException - InvalidArgumentException.