Github user revans2 commented on a diff in the pull request:
https://github.com/apache/storm/pull/1029#discussion_r50278349
--- Diff:
storm-core/src/jvm/org/apache/storm/trident/operation/TridentCollector.java ---
@@ -20,7 +20,33 @@
import java.util.List;
+/**
+ * Interface for publishing tuples to a stream and reporting exceptions
(to be displayed in Storm UI).
+ *
+ * Trident components that have the ability to emit tuples to a stream are
passed an instance of this
+ * interface.
+ *
+ * For example, to emit a new tuple to a stream, you would do something
like the following:
+ *
+ * ```java
+ * collector.emit(new Values("a", "b", "c"));
+ * ```
+ * @see storm.trident.Stream
+ * @see backtype.storm.tuple.Values
+ */
public interface TridentCollector {
+ /**
+ * Emits a tuple to a Stream
+ * @param values a list of values of which the tuple will be composed
+ */
void emit(List<Object> values);
+
+ /**
+ * Reports an error. The corresponding stack trace will be visible in
the Storm UI.
+ *
+ * Note that calling this method does not alter the processing of a
batch. To explicitly fail a batch and trigger
+ * a replay, components should throw {@link
backtype.storm.topology.FailedException}.
--- End diff --
Link here too
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
