com.twitter.heron.api.spout

Class SpoutOutputCollector

java.lang.Object

com.twitter.heron.api.spout.SpoutOutputCollector

All Implemented Interfaces:

ISpoutOutputCollector

public class SpoutOutputCollector
extends java.lang.Object
implements ISpoutOutputCollector

This output collector exposes the API for emitting tuples from an backtype.heron.topology.IRichSpout. The main difference between this output collector and OutputCollector for backtype.heron.topology.IRichBolt is that spouts can tag messages with ids so that they can be acked or failed later on. This is the Spout portion of Heron's API to guarantee that each message is fully processed at least once.

Constructor Summary

Constructors

Constructor and Description
SpoutOutputCollector(ISpoutOutputCollector delegate)

Method Summary

Methods

Modifier and Type	Method and Description
java.util.List<java.lang.Integer>	emit(java.util.List<java.lang.Object> tuple) Emits a tuple to the default output stream with a null message id.
java.util.List<java.lang.Integer>	emit(java.util.List<java.lang.Object> tuple, java.lang.Object messageId) Emits a new tuple to the default output stream with the given message ID.
java.util.List<java.lang.Integer>	emit(java.lang.String streamId, java.util.List<java.lang.Object> tuple) Emits a tuple to the specified output stream with a null message id.
java.util.List<java.lang.Integer>	emit(java.lang.String streamId, java.util.List<java.lang.Object> tuple, java.lang.Object messageId) Emits a new tuple to the specified output stream with the given message ID.
void	emitDirect(int taskId, java.util.List<java.lang.Object> tuple) Emits a tuple to the specified task on the default output stream.
void	emitDirect(int taskId, java.util.List<java.lang.Object> tuple, java.lang.Object messageId) Emits a tuple to the specified task on the default output stream.
void	emitDirect(int taskId, java.lang.String streamId, java.util.List<java.lang.Object> tuple) Emits a tuple to the specified task on the specified output stream.
void	emitDirect(int taskId, java.lang.String streamId, java.util.List<java.lang.Object> tuple, java.lang.Object messageId) Emits a tuple to the specified task on the specified output stream.
void	reportError(java.lang.Throwable error)

Methods inherited from class java.lang.Object

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

Constructor Detail

SpoutOutputCollector

public SpoutOutputCollector(ISpoutOutputCollector delegate)

Method Detail

emit

public java.util.List<java.lang.Integer> emit(java.lang.String streamId,
                                     java.util.List<java.lang.Object> tuple,
                                     java.lang.Object messageId)

Emits a new tuple to the specified output stream with the given message ID. When Heron detects that this tuple has been fully processed, or has failed to be fully processed, the spout will receive an ack or fail callback respectively with the messageId as long as the messageId was not null. If the messageId was null, Heron will not track the tuple and no callback will be received. The emitted values must be immutable.

Specified by:

emit in interface ISpoutOutputCollector

Returns:

the list of task ids that this tuple was sent to

emit

public java.util.List<java.lang.Integer> emit(java.util.List<java.lang.Object> tuple,
                                     java.lang.Object messageId)

Emits a new tuple to the default output stream with the given message ID. When Heron detects that this tuple has been fully processed, or has failed to be fully processed, the spout will receive an ack or fail callback respectively with the messageId as long as the messageId was not null. If the messageId was null, Heron will not track the tuple and no callback will be received. The emitted values must be immutable.

Returns:

the list of task ids that this tuple was sent to

emit

public java.util.List<java.lang.Integer> emit(java.util.List<java.lang.Object> tuple)

Emits a tuple to the default output stream with a null message id. Heron will not track this message so ack and fail will never be called for this tuple. The emitted values must be immutable.

emit

public java.util.List<java.lang.Integer> emit(java.lang.String streamId,
                                     java.util.List<java.lang.Object> tuple)

Emits a tuple to the specified output stream with a null message id. Heron will not track this message so ack and fail will never be called for this tuple. The emitted values must be immutable.

emitDirect

public void emitDirect(int taskId,
              java.lang.String streamId,
              java.util.List<java.lang.Object> tuple,
              java.lang.Object messageId)

Emits a tuple to the specified task on the specified output stream. This output stream must have been declared as a direct stream, and the specified task must use a direct grouping on this stream to receive the message. The emitted values must be immutable.

Specified by:

emitDirect in interface ISpoutOutputCollector

emitDirect

public void emitDirect(int taskId,
              java.util.List<java.lang.Object> tuple,
              java.lang.Object messageId)

Emits a tuple to the specified task on the default output stream. This output stream must have been declared as a direct stream, and the specified task must use a direct grouping on this stream to receive the message. The emitted values must be immutable.

emitDirect

public void emitDirect(int taskId,
              java.lang.String streamId,
              java.util.List<java.lang.Object> tuple)

Emits a tuple to the specified task on the specified output stream. This output stream must have been declared as a direct stream, and the specified task must use a direct grouping on this stream to receive the message. The emitted values must be immutable.

Because no message id is specified, Heron will not track this message so ack and fail will never be called for this tuple.

emitDirect

public void emitDirect(int taskId,
              java.util.List<java.lang.Object> tuple)

Emits a tuple to the specified task on the default output stream. This output stream must have been declared as a direct stream, and the specified task must use a direct grouping on this stream to receive the message. The emitted values must be immutable.

Because no message id is specified, Heron will not track this message so ack and fail will never be called for this tuple.

reportError

public void reportError(java.lang.Throwable error)

Specified by:

reportError in interface ISpoutOutputCollector