com.amazonaws.services.kinesis.multilang

Class MultiLangDaemon

java.lang.Object

com.amazonaws.services.kinesis.multilang.MultiLangDaemon

All Implemented Interfaces:

java.util.concurrent.Callable<java.lang.Integer>

public class MultiLangDaemon
extends java.lang.Object
implements java.util.concurrent.Callable<java.lang.Integer>

Main app that launches the worker that runs the multi-language record processor. Requires a properties file containing configuration for this daemon and the KCL. A properties file should at minimum define these properties:

 # The script that abides by the multi-language protocol. This script will
 # be executed by the MultiLangDaemon, which will communicate with this script
 # over STDIN and STDOUT according to the multi-language protocol.
 executableName = sampleapp.py

 # The name of an Amazon Kinesis stream to process.
 streamName = words

 # Used by the KCL as the name of this application. Will be used as the name
 # of a Amazon DynamoDB table which will store the lease and checkpoint
 # information for workers with this application name.
 applicationName = PythonKCLSample

 # Users can change the credentials provider the KCL will use to retrieve credentials.
 # The DefaultAWSCredentialsProviderChain checks several other providers, which is
 # described here:
 # http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/DefaultAWSCredentialsProviderChain.html
 AWSCredentialsProvider = DefaultAWSCredentialsProviderChain
 

Constructor Summary

Constructors

Constructor and Description
MultiLangDaemon(KinesisClientLibConfiguration configuration, MultiLangRecordProcessorFactory recordProcessorFactory, java.util.concurrent.ExecutorService workerThreadPool) Constructor.
MultiLangDaemon(Worker worker)

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Integer	call()
static void	main(java.lang.String[] args)
static void	printUsage(java.io.PrintStream stream, java.lang.String messageToPrepend) Utility for describing how to run this app.

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiLangDaemon

public MultiLangDaemon(KinesisClientLibConfiguration configuration,
               MultiLangRecordProcessorFactory recordProcessorFactory,
               java.util.concurrent.ExecutorService workerThreadPool)

Constructor.

Parameters:

configuration - The KCL config to use.

recordProcessorFactory - A record processor factory to create record processors that abide by the multi-lang protocol.

workerThreadPool - The executor service to run the daemon in.

MultiLangDaemon

public MultiLangDaemon(Worker worker)

Parameters:

worker - A worker to use instead of the default worker.

Method Detail

printUsage

public static void printUsage(java.io.PrintStream stream,
              java.lang.String messageToPrepend)

Utility for describing how to run this app.

Parameters:

stream - Where to output the usage info.

messageToPrepend - An optional error message to describe why the usage is being printed.

call

public java.lang.Integer call()
                       throws java.lang.Exception

Specified by:

call in interface java.util.concurrent.Callable<java.lang.Integer>

Throws:

java.lang.Exception

main

public static void main(java.lang.String[] args)

Parameters:

args - Accepts a single argument, that argument is a properties file which provides KCL configuration as well as the name of an executable.