docker版jxTMS使用指南：本地数据总线

本文讲解4.4版jxTMS中的本地数据总线，整个系列的文章请查看：docker版jxTMS使用指南：4.4版升级内容

docker版本的使用，请查看：docker版jxTMS使用指南

4.0版jxTMS的说明，请查看：4.0版升级内容

4.2版jxTMS的说明，请查看：4.2版升级内容

4.4版jxTMS中增加了一个本地的数据总线。听起来似乎很高大上的，其实就是一种数据接收通知：源发送数据，感兴趣的接收方得到通知。既是一种数据交换机制，更是一种本机的、隔离的事件通知机制。

数据总线有两个参与方：

• 数据源：发送数据者

• 目标：对数据源发送的数据感兴趣者

数据源和目标之间没有任何约束，目标和目标之间也不存在约束与干扰。

引用：

from jx.jxLocalDataBus import jxLocalDataBus

jxLocalDataBus的类函数

registerSource(cls, type, source, siteType=None, siteName=None, varList={})

注册数据源

参数：
	type：数据源类型，如设备就使用自己的设备类型
	source：数据源名，如设备就使用自己的设备名
	siteType：数据源所在站点类型
	siteName：数据源所在站点名
	varList：如果是同质的数据源，可以用一个数据源来概括，这些数据源之间用不同的变量来区分，现在大家暂时可以不考虑
说明：
	如source是：ds-{id}。则代表了：ds-1，ds-2，ds-3，...。这是时数据源的区分就要用到varList：{'id':1}、{'id':2}、{'id':3}等等

unRegisterSource(cls, source)

取消数据源

参数：
	source：数据源名，如设备就使用自己的设备名

getInterestedVisitor(cls, str ,debug=False)

将字符串的判断表达式，即数据源的字符串形式，转换为判定式对象。也就是说，本地数据总线并不是单纯的数据广播，而是只通知那些根据此处的判断表达式判定对自己感兴趣的目标。

参数：
	str：数据源的字符串形式
	debug：是否打开调试
示例：
	表达式【t1.s1.v1】，是对设备类型【t1】设备名【s1】的变量【v1】感兴趣
	表达式【t1.s1:st2.sn2.v1】，是对位于站点类型【st2】的站点【sn2】中的设备类型【t1】设备名【s1】的变量【v1】感兴趣

registerTarget(cls, name, receiveFunc, interestedVisitorList)

注册感兴趣者的接收对象

参数：
	name：感兴趣者的名字
	receiveFunc：接收对象
	interestedVisitorList：用getInterestedVisitor得到的判定式的list
说明：
	receiveFunc的签名是：
	receiveFunc(sendObj,vn,v)
	#sendObj是发送数据时送入的发送者对象
	#vn是感兴趣的变量，v是源发送的数据

unRegisterTarget(cls, name)

取消接收对象

参数：
	name：感兴趣者的名字

inform(cls, sendObj, source, data)

发送数据通知

参数：
	sendObj：发送数据通知时的对象
	source：数据源名，如设备就使用自己的设备名
	data：数据
说明：
	发送的数据中，有的目标可能对某个数据感兴趣，有的可能对另外的数据感兴趣，甚至可能没人感兴趣，但这些和数据源没关系，目标之间也没有关系

目前，设备device类在初始化完毕后，会将自己注册为数据源：

jxLocalDataBus.registerSource(self._type,self._name,
	siteType=mySite.type(),siteName=mySite.name(),
	varList=self.varList())

并在接收到数据并处理完毕后，将其发送出来

jxLocalDataBus.inform(self,self._name,self._data)

所以，如果对某个设备的数据感兴趣，就可以注册一个目标来接收其发送的数据，如：

v = jxLocalDataBus.getInterestedVisitor('vrs20.vrs20-1.Level')
jxLocalDataBus.registerTarget('test1',recvVRSLevel,[v])

则当设备vrs20-1在接收到前端发送的潮位数据后，就可以在recvVRSLevel函数中接收到其处理后的潮位数据了，由于device在inform时把自身当做sendObj送出，所以recvVRSLevel函数中还可以调用sendObj.data()取到完整的设备数据。

数据投递的说明

当一个数据源做投递时，其行为逻辑是：

• 对所有对自己感兴趣的目标依次投递

• 对每一个目标，对其所有的判决式依次运行，如果有一个通过就投递给该目标并结束后继判决式的运行，然后转下一个对自己感兴趣的目标进行投递

有时，可能会同时对多个数据点产生兴趣，这就是用registerTarget注册目标时，interestedVisitorList是一个list的原因。

根据上述的投递行为逻辑，多个数据点时它们相当于or连接，只要有一个判决式成立，目标就会被触发，并收到第一个成立的数据。

所以当目标指定了自己对多个数据点有兴趣时，目标自身必须清晰的理解这一点：只要这些数据点中有一个得到了满足，自己就会得到通知。然后据此编写自己的处理逻辑。

概要之，数据总线，就是通知自己有了数据更新，感兴趣者可以收到更新后的数据，并得到一个触发的机会。

其优势在于收发双方、接收者之间，并没有任何严格的逻辑约束，具有较好的隔离性。也就是说，接收目标即便执行失败、掷出异常也不会产生任何影响。

参考资料：

jxTMS设计思想

jxTMS编程手册

下面的系列文章讲述了如何用jxTMS开发一个实用的业务功能：

如何用jxTMS开发一个功能

下面的系列文章讲述了jxTMS的一些基本开发能力：

jxTMS的HelloWorld