TLP消息协议

概述

TLP消息协议（TLP Message Protocol，简称TLP-MP）为TLP系统中的软件组件提供了“请求-应答”式和广播式的消息传输机制。

在TLP系统中，软件组件之间需要跨进程和跨网络的服务调用机制，并且软件组件需要将产生的事件异步地通知给多个其它的软件组件。TLP-MP采用了在消息总线上提供“发布-订阅”操作的方式来满足这两种需求：

为了对消息的传输进行权限控制，TLP-MP将每个消息路径视作资源地址，并定义了如下几种请求消息的操作类型，便于权限控制组件根据地址和操作类型进行访问控制：

TLP-MP中的消息由消息地址、消息头和消息体构成：

消息地址是一段由‘/’符号分隔的字符串，格式为：

/MP/1.0/<controllerId>/(events|services|components)/[...]

说明

<controllerId>是控制器在一个控制器网络中的唯一标识。

在TLP-MP中，一共有5类地址：

/MP/1.0/<controllerId>/services/<serviceId>/...

说明

<serviceId>是服务的唯一标识，相同的服务具有相同的serviceId。
默认服务是指当有多个软件组件提供相同serviceId的服务时，默认被访问的那一个服务实现。当系统中仅有一个软件组件提供某serviceId所代表的服务时，那么该服务即自动被认为是默认服务。当有多个选择时，默认服务通常由管理员决定。

/MP/1.0/<controllerId>/events/<serviceId>/...

/MP/1.0/<controllerId>/components/<componentId>/services/<serviceId>/...

说明

<componentId>是控制器范围内软件组件的唯一标识。

/MP/1.0/<controllerId>/components/<componentId>/events/<serviceId>/...

/MP/1.0/<controllerId>/components/<componentId>/results/<serviceId>/...

TLP-MP的消息头中包含了消息相关的信息，这些信息已以键值对的形式体现，每个键值对称为一个字段，消息头可包含多个字段。

示例

{
    "method": "GET",
    "sender": "Xn2iZkj9",
    "correlation": 23123243,
    "contentType": "applications/cbor"
}

示例

{
  "method": "GET",
  "sender": "Xn2i2kak",
  "correlation": 23123243,
  "contentType": "applications/cbor",
  "code": 200,
  "message": "Success"
}

字段名	取值范围	含义
event	字符串	事件名
contentType	Media Types	消息体的编码格式

示例

{
  "event": "BridgePresence",
  "contentType": "applications/cbor"
}

TLP-MP的消息体用来承载消息的具体内容，其编码格式由消息头中的contentType决定。

TLP-MP支持以MQTT 3.1.1为承载协议，其中：