免费注册

【技术实践】apollo1.7.1初探(二)使用apollo订阅主题,发布主题消息

2019-02-15 人浏览

一、MQTT协议配置 为了使用MQTT协议,首先使用MQTT3. 1协议的客户端连接到Apollo正在监听端口。 如果你一定指定连接的协议,有下面两种方式:你可以选择不用协议识别,而是为MQTT指定连接:

一、MQTT协议配置

为了使用MQTT协议,首先使用MQTT3.1协议的客户端连接到Apollo正在监听端口。Apollo会做协议检测,而且自动识别MQTT连接,而且将连接作为MQTT协议处理。

你不必要为MQTT协议打开一个端口(STompOpenfireAMQP等都是自动识别)。如果你一定指定连接的协议,有下面两种方式:你可以选择不用协议识别,而是为MQTT指定连接:
<connector id="tcp" bind="tcp://0.0.0.0:61613" protocol="mqtt"/>

或者你可以限制哪种协议可以被自动识别。通过下面的<detece>配置方式:
<connector id="tcp" bind="tcp://0.0.0.0:61613">
  <detect protocols="mqtt openwire" />
</connector>
<detect>

protocols 对应的参数通过空格来隔开支持的通信协议。

如果只支持一种协议,就不要空格,默认情况下对任何协议生效。

如果你想调整MQTT默认设置,在apollo.xml文件中有一个<connector> 元素,通过MQTT参数配置:
<connector id="tcp" bind="tcp://0.0.0.0:61613">
  <mqtt max_message_length="1000" />
</connector>
MQTT
元素支持下面几个参数:
max_message_length : The size (in bytes) of the largest message that can be sent to the broker. Defaults to 100MB
broker能接受的最大消息量:默认是100M
protocol_filters : A filter which can filter frames being sent/received to and from a client. It can modify the frame or even drop it.(
一个控制发送和接收,Client的过滤器框架。可以修改,删除这个框架)
die_delay : How long after a connection is deemed to be “dead” before the connection actually closes; default: 5000ms
(在实际断开连接之前,会有默认5000ms的时间被认为连接已经dead
mqtt 
配置元素也可以用来控制目的消息头的解析。

下面是支持的参数:
queue_prefix : a tag used to identify destination types; default: null
(用来确认目的地类型)
path_separator : used to separate segments in a destination name; default: /
(用来分割目的地名称)
any_child_wildcard : indicate all child-level destinations that match the wildcard; default: +
(识别子目录)
any_descendant_wildcard : indicate destinations that match the wildcard recursively; default:#
(目标地址通配符)
regex_wildcard_start : pattern used to identify the start of a regex
(表示正则表达开始)
regex_wildcard_end : pattern used to identify the end of a regex
(表示正则表达结束)
part_pattern : allows you to specify a regex that constrains the naming of topics. 
(你可以指定正则表达规则)default: [ a-zA-Z0-9\_\-\%\~\:]+
 Client 
可用函数库
Apollo 
支持MQTT3.1 协议,下面是可用的Clients:
Java : mqtt-client, MeQanTT
C : libmosquitto
Erlang : erlmqtt, my-mqtt4erl
.NET : MQTTDotNet, nMQTT
Perl : net-mqtt-perl, [anyevent-mqtt-perl]https://github.com/beanz/anyevent-mqtt-perl()
Python : nyamuk
Ruby : mqtt-ruby, ruby-em-mqtt
Javascript : Node.js MQTT Client
Delphi : TMQTTCLient
Device specific: Arduino, mbed, Nanode, Netduino
如果要找到新支持的Clients ,可以检索:the MQTT website for its software
在目录example 目录下,你可以找到一些例子,实现了与broker之间收发。
 connecting
为了确保broker配置文件的安全,所以只允许一个admin 用户连接,默认的用户名和密码是:admin ,password.
Mqtt 
客户端不能specify 虚拟主机(更多请看:see the section on Virtual Hosts in the user guide),以至于默认情况下虚拟主机已经被使用了。通常第一虚拟主机定义在apollo.xml文件中。
 Destination 
类型
MQTT
协议是订阅,发布协议,是不允许真正的利用队列点对点的消息收发。因此Apollo仅允许利用主题,还进行MQTT消息发送。订阅的概念和持久的主题订阅 和其他协议提到的有些类似,同时也被MQTT CONNECT 框架的clean session属性控制。
 Clean Sessions
但一个Client 发送一个连接,这个连接中clean session 被设置为false,那么之前连接中有相同Client_id session 将会被重复使用。这就意味着Client断开了,订阅依然能收到消息。这就等同与同Apollo建立一个长订阅。
如果 clean session 设置为true ,那么新session就开始了,其他的session会慢慢消失,删除。这就是Apollo中定义的普通的主题订阅。
 Topic Retained Messages
如果消息被发布的同时retain 标记被设置,消息将被主题记住,以至于新的订阅到达,最近的retain 消息会被发送到订阅者。比如说:你想发布一个参数,而且你想让最新的这个参数发布到总是可用的订阅了这个主题的客户端上,你就设置在PUBLISH 框架上设置retain 标签。
注意:retained 消息 不会被设置成retained  QoS设置为零的broker 重启过程中。
Last Will and Testament Message
Client第一次连接的时候,有一个will 消息和一个更QoS相关的消息会跟你有关。will消息是一个基础消息,这个基础消息只有在连接异常或者是掉线的时候才会被发送。一般用在你有一个设备,当他们掉了的时候,你需要知道。所以如果一个医疗Clientbroker掉线,will消息将会作为一个闹钟主题发送,而且会被系统作为高优先级提醒。
Reliable Messaging
MQTT
协议允许Client 发布消息的时候指定Qos参数:
At Most Once (QoS=0)
At Least Once (QoS=1)
Exactly Once (QoS=2)
 
最多一次
这个设置时推送消息给Client,可靠性最低的一种。如果设置Qos=0,那broker就不会返回结果码,告诉你他收到消息了,也不会在失败后尝试重发。这有点像不可靠消息,如JMS
 
至少一次
该设置会确保消息会被至少一次推送到Client。如果推送设置为至少推送一次,Apollo会返回一个回调函数,确保代理已经收到消息,而且确保会确保推送该消息。如果Client 将发布了一个Qos=1的消息,如果在指定的时间内没有收到回复,Client会希望重新发布这个消息。所以可能存在这种情况:代理收到一个需要推送的消息,然后又收到一个消息推送到同一个Client。所以如果传输过程中PUBACK丢失,Client会重新发送,而且不会去检测是否是重发,broker就将消息发送到订阅主题中。
 
恰好一次
该设置是可靠等级最高的。他会确保发布者不仅仅会推送,而且不会像Qos=1 那样,会被接收两次。当然这个设置会增加网络的负载。当一个消息被发布出去的时候,broker会保存该消息的id,而且会利用任何长连接,坚持要把该消息推送给目标地址。如果Client收到PUBREC 标志,那就表明broker已经收到消息了。 这个时候broker会期待Client发送一个PUBREL 来清除session 中消息idbroker如果发送成功就会发送一个PUBCOMP通知Client

二、Wildcard Subscriptions

通配用在主题的目标地址中。这能实现一个主题发送到多个用户,或者多层用户中。
/ is used to separate names in a path
(分割路径)
+ is used to match any name in a path
(通配地址任何字符)
# is used to recursively match path names
(递归通配)
比如通配可能这样来用:
PRICE/# : Any price for any product on any exchange
(任何交易中任何产品的价格)
PRICE/STOCK/# : Any price for a stock on any exchange
(任何交易中的股票价格)
PRICE/STOCK/NASDAQ/+ : Any stock price on NASDAQ
(纳斯达克的任何股票价格)
PRICE/STOCK/+/IBM : Any IBM stock price on any exchange
(任何交易中IBM股票价格)
Keep Alive
Apollo
只有在Client指定了CONNECTKeepAlive 值的时候,才会设置保持连接、心跳检测。如果one Client指定了keepalive,apollo 将会使用1.5*keepalive值。这个在MQTT中有说明。
Destination Name Restrictions
路径名称限制了使用(a-z, A-Z, 0-9, _, - %, ~, :, ' ', '(', ')' . )字符,通配符(*)在复杂的分隔符中。而且确保使用utf-8来编译你的URL

高传集

职务:云服务集团云计算产品中心首席架构师

专业领域:云计算

专家简介:2006年加入浪潮,负责浪潮云PaaS产品服务的研发。致力于打造一套高性能、可弹性扩展的PaaS产品服务,帮助用户在云原生时代更好的构建、交付、管理自己的应用平台。

 

 


上一篇: 【技术实践】apollo1.7.1初探(一)安装apollo、创建并启动broker
下一篇: 【技术实践】ssl双向认证

相关文章