Storm之Collector-p1
IBasicOutputCollector.java List<Integer> emit(String streamId, List<Object> tuple); 提交一系列的tuple,返回接收到这些tuple的taskId void emitDirect(int taskId, String streamId, List<Object> tuple); 直接向某个task提交一系列的tuple BasicOutputCollector.java 这个类里封装了一个OutputCollector的代理和一个inputTuple OutputCollector是在构造函数里传入的,在Bolt处理完tuple之后调用此类的emit方法时,方法内部会调用封装的OutputCollector来进行emit, 最终的emit是OutputCollector的emit 此类还提供了两个emit方法的重载,目的是在没有指定streamId的时候提供一个默认名为“default”的streamId. 此类的emit方法没有提供anchors参数,每次bolt执行完之后进行emit时会自动将输入tuples和输出tuples关联,如果不需要关联,则可不用此类。 IOutputCollector.java List<Integer> emit(String streamId, Collection<Tuple> anchors, List<Object> tuple); 提交一系列的tuple,返回接收到这些tuple的taskId,anchors参数是指接收到的tuples void emitDirect(int taskId, String streamId, Collection<Tuple> anchors, List<Object> tuple); 直接向某个task提交一系列tuple,同样的也会附带上输入的tuple void ack(Tuple input); ack某个tuple void fail(Tuple input); fail某个tuple OutputCollector.java 封装了一个IOutputCollector的代理,该代理在构造函数时传递进来被初始化。 提供了多个emit方法的重载,基本上包括有(单个anchor,无anchor,无指定streamId,只有输出的tuple)这些 emitDirect重载的方式也基本上一样,都是为了使用方便来做的。 当然,最终的emit,ack和fail都是通过代理来实现的。 CoordinatedOutputCollector.java 这个类比较奇葩,是定义在CoordinatedBolt的内部类,只有CoordinatedBolt这个类使用。 封装了一个IOutputCollector代理,该代理在构造函数时被初始化。 此类没有重载emit和emitDirect方法,但是在emit和emitDirect方法内部会调用一个名为updateTaskCounts的方法 private void updateTaskCounts(Object id, List<Integer> tasks) { synchronized(_tracked) { TrackingInfo track = _tracked.get(id); if (track != null) { Map<Integer, Integer> taskEmittedTuples = track.taskEmittedTuples; for(Integer task: tasks) { int newCount = get(taskEmittedTuples, task, 0) + 1; taskEmittedTuples.put(task, newCount); } } } } 这个方法主要是更新目标task和向其发送的tuple数量关系,其关系维护在_tracked变量里,关系链为 tuple_id —> task_id —> num public void ack(Tuple tuple) { Object id = tuple.getValue(0); synchronized(_tracked) { TrackingInfo track = _tracked.get(id); if (track != null) track.receivedTuples++; } boolean failed = checkFinishId(tuple, TupleType.REGULAR); if(failed) { _delegate.fail(tuple); } else { _delegate.ack(tuple); } } 将收到的tupleID对应的跟踪信息中receivedTuples(已接收数量)+1 ,然后检查是否已经处理完该tupleID对应的任务,如果检查失败就fail回上一个bolt TupleType.REGULAR是为了保证不是传递ID的也不是传递数量的流。 public void fail(Tuple tuple) { Object id = tuple.getValue(0); synchronized(_tracked) { TrackingInfo track = _tracked.get(id); if (track != null) track.failed = true; } checkFinishId(tuple, TupleType.REGULAR); _delegate.fail(tuple); } 设置跟踪信息failed,然后checkFinishId方法中会fail所有应该ack的tuples,然后删除这个tupleID对应的跟踪信息