Bolt是Topology中的数据处理的单元,也是Storm针对处理过程的编程单元。Topology中所有的处理都是在这些Bolt中完成的,编程人员可以实现自定义的处理过程,例如,过滤、函数、聚集、连接等计算。如果是复杂的计算过程,往往需要多个步骤和使用多个Bolt。
Bolt可以将数据项发送至多个数据流(Stream)。编程人员首先可以使用OutputFieldsDeclarer类的declareStream()方法来声明多个流,指定数据将要发送到的流,然后使用SpoutOutputCollector的emit方法将数据发送。
当声明了一个Bolt的输入流后,可以从其他的组件中接收这些指定的流。当接收某个组件的所有流时,需要在程序中逐个声明接收的过程。InputDeclarer对象默认接收来自某组件默认的流。
//从名称为"1"的组件中接收默认的流。 declarer.shuffleGrouping("1")
IBolt 和 IComponent接口
IBolt接口:
//在组件的任务初被初始化时,由集群中的工作进程(worker)调用,prepare()用于实例化Bolt的已给运行时任务,被集群中的某一个进程调用,提供Bolt运行的环境。//sormConf对象维护Storm中针对该Bolt的配置信息。(来自Topology);context对象是一个上下文对象,用于获取该组件运行时任务的信息。(例如Topology中该Bolt所有任务的位置,包括任务的id、组件id和输入输出信息等)//collector对象用于从该Bolt发送数据项。数据项可以在任意时刻发送,包括调用open()和close()方法。 void prepare(java.util.Map stormConf,TopologyContext context,OutputCollector collector) //接收一个数据项并处理//该方法用来接收一个数据项(Tuple),并可以将处理的结果作为新的数据项发送(emit),是Bolt需要实现的最重要的方法。//参数imput是一个数据项对象,包含了众多的元数据(metadata),包括它来自的组件、流、任务等。数据项中的值,可以通过Tuple类的getValue()方法获得。 void execute(Tuple input) //在IBolt将关闭时调用 void cleanup()
Tuple类的方法,这个类的对象作为execute()方法的输入。(方法举例: int size() ; int fieldIndex(java.lang.String field) ; ......)
方法众多,可以整理分为以下五类:
1、获取属性的方法。 (size()、fieldIndex()和contains()三个方法)
2、获取元数据的方法。(getMessageId()、getSourceComponent()、getSourceTask()、getSourceStreamId()和getSourceGlobalStreamid()方法)
其中MessageId是在数据项被创建时,通过一定的规则赋值的。
3、根据域获取值的方法。(getValue()和多个get具体数据类型的方法)
4、根据域的名称获取值的方法。(这一类包括getFields()、getValues()和select()方法)
5、获取Tuple的值或域列表的方法。(getFields()、getValues()和select()方法)
分别获取该数据项的所有域列表、值列表和值列表子集。