这一次,介绍一下阿里云iot的一类比较重要API接口操作:topic管理,说到topic,这个概念其实应该是起源于mqtt协议的,
mqtt协议作为目前物联网的主要通信协议,最开始,大概上个世纪90年代,是由IBM为了M2M[machine to machine]场景[比如传感器和卫星链接]而定义,开发和使用的;后来随着物联网的兴起,逐渐成为物联网通信的主流协议,也被OASIS标准组织官方所采纳,目前在mqtt的官方网站http://mqtt.org/
,最新的版本是今年3月份发布的5.0版本;mqtt主要有三个比较重要的概念,sub,pub和topic,由于mqtt使客户端加服务器的结构,所以当一个设备向另一个设备发送消息时,接收消息的设备首先要订阅这个设备发送的这类消息;这个过程为sub[subscribe],而发送消息的设备实际上是发给服务器,然后转到接收消息的设备,所以发送消息的过程被称作pub[public],而不同类别的消息通常是发到不同的设备上;所以消息的类别名称可以理解为topic,或者叫主题;关于topic更详细的定义信息,读者感兴趣可以参考mqtt官方网站上的
5.0版本的文档说明,比如topic标准定义为$开头,中间用/斜线作为等级划分的字符串;
介绍完topic相关的一些基本信息后,下面就开始介绍阿里云IOT云端如何使用api接口,对topic进行管理的了;
本次用来实验和验证的软件链接如下:
http://xysuger.xunyun17.xyz/v0.0.8.rar
读者如果感兴趣的话,可以自行下载运行验证;
关于topic的api接口,一共有8个,可以分为两类,分别是topic的基本操作和topic路由表的操作;下面先来看一下topic的基本操作,由于topic通常都是和产品关联的,所以基本操作的四个api接口命令里,都带有product字符串,这四个接口分别是创建,查询,更新和删除产品相关的topic,下面先来看一下如何创建产品的topic,创建的命令为CreateProductTopic,这个命令带有三个参数,第一个为产品的关键字标识符,这里为a141rgUXgFl,第二个参数为topic的名称,这里
为XYsuger,第三个为这个topic的操作权限,这里有三种取值:SUB,PUB,ALL分别对应订阅,发布和订阅+发布;这里为PUB表示发布;最后的命令字符串为:
XYsayFrO.IoT.Srv.CreateProductTopic.a141rgUXgFl.XYsuger.PUB.
运行后,得到如下图所示,
这里可以看到,除了通常的requestid,success返回值,还多了一个topicid,这个表示成功创建topic后,这个topic所对应的唯一的一个id号码,后续操作需要用到这个值来作为参数;
成功创建好topic后,我们可以使用QueryProductTopic命令,来查询已经存在topic,这条命令只需带入一个参数,也就是产品的关键识别符,即可列出这个产品下的所有topic,最后的完整命令如下:
XYsayFrO.IoT.Srv.QueryProductTopic.a141rgUXgFl.
运行后,得到如下图所示,
从命令的返回结果,可以看到产品的topic列表里,第一个就是我们刚才创建的topic:XYsuger,而且id号就是topicid和刚才创建时返回的是一样的;另外,这里的operation后面的数字,代表我们刚才传入的sub,pub,all的操作权限,具体的对应关系为0-PUB,1-SUB,2-ALL.
成功查询产品的TOPIC列表后,我们就可以通过UpdateProductTopic指令,来修改相应topic的操作权限,比如我们这里作为一个演示的例子,把刚才创建topic的操作权限由PUB改为ALL,那么完整的命令如下,这里有三个参数,一个是TOPIC的ID,第二个为操作权限,第三个为TOPIC的名称:
XYsayFrO.IoT.Srv.UpdateProductTopic.5768271.ALL.XYsuger.
修改好后,我们再用刚才的查询命令确认一下,返回结果信息如图:
这里可以看到operation的值已经由0改为2,证明我们刚才的操作运行成功;
最后一个基本操作是删除topic,操作指令为DeleteProductTopic,带有一个参数表示要删除的topicid,这里为 5768271,完整指令如下:
XYsayFrO.IoT.Srv.DeleteProductTopic.5768271.
删除后,我们同样运行上面查询的指令,运行结果如下图所示:
这里从查询的信息,可以看到我们刚才创建名字为XYsuger的topic,已经不再查询结果列表中了,证明删除操作生效了;
下面来介绍和演示topic路由表相关的操作,topic路由表的具体含义,顾名思义,就是将一个设备的topic转到本设备内部另外一个topic,或者另外一个设备的topic上,实现真正意义上的设备内部逻辑转换或设备和设备通信,下面来看topic路由表的第一个操作,创建topic路由表,操作指令名称:CreateTopicRouteTable,带有两个参数,原topic和要转接到topic,这里作为演示的例子,将刚才创建的XYsuger这个topic,转换到这个设备的update更新的topic上,完整指令格式如下:
XYsayFrO.IoT.Srv.CreateTopicRouteTable./a141rgUXgFl/lamp3_dev/XYsuger./a141rgUXgFl/lamp3_dev/update.
运行后,会返回下面的信息;
这里看到success为true,就表示创建成功;
然后使用QueryTopicRouteTable指令,查询创建好的topic路由,这里只要传入要查询的源topic作为参数即可;指令如下:
XYsayFrO.IoT.Srv.QueryTopicRouteTable./a141rgUXgFl/lamp3_dev/XYsuger.
运行结果如下:
可以看到,topic后面的返回信息,正是我们刚才创建路由的目标topic的信息。
除了正向查找路由,还可以反向查找路由,也就是说通过目标topic的信息,查找路由表里原topic的信息;指令名称为QueryTopicReverseRouteTable,这里带入目标的topic作为参数,完整格式如下:
XYsayFrO.IoT.Srv.QueryTopicReverseRouteTable./a141rgUXgFl/lamp3_dev/update.
运行结果如下:
这里可以看到,查找到的原topic信息为XYsuger,表示查找正确;
最后一个关于topic路由表的操作,为删除topic路由表,指令名称为DeleteTopicRouteTable,带入的两个参数分别为这条路由的原topic和目标topic,这里我们删除刚才创建的topic路由,完整的指令格式如下:
XYsayFrO.IoT.Srv.DeleteTopicRouteTable./a141rgUXgFl/lamp3_dev/XYsuger./a141rgUXgFl/lamp3_dev/update.
运行结果如下:
这里的返回信息,success的值为true,表示删除成功;
到这里,topic管理方面的相关api操作,就已经介绍完了,谢谢收看;