Package cn.herodotus.engine.message.mqtt.gateway

Interface MessageSendingGateway

public interface MessageSendingGateway

Description: Mqtt 消息发送网关定义

Author:

: gengwei.zheng

Date:

: 2023/9/11 16:10

Method Summary

Modifier and Type	Method	Description
void	publish(Integer qos, String payload)	使用 默认 Topic 和 自定义 Qos 发送数据
void	publish(String payload)	使用 默认 Topic 和 默认 Qos 发送数据
void	publish(String topic, Integer qos, byte[] payload)	使用 自定义 Topic 和 自定义 Qos 发送数据
void	publish(String topic, Integer qos, String payload)	使用 自定义 Topic 和 自定义 Qos 发送数据
void	publish(String topic, String payload)	使用 自定义 Topic 和 Qos 发送数据
void	publish(String topic, String responseTopic, String correlationData, Integer qos, String payload)	发送请求响应的消息（MQTT v5新特性）

Method Details

publish

void publish(String payload)

使用 默认 Topic 和 默认 Qos 发送数据

Parameters:

payload - string 类型内容

publish

void publish(@Header("mqtt_qos")
 Integer qos,
 String payload)

使用 默认 Topic 和 自定义 Qos 发送数据

Parameters:

qos - Qos 等级

payload - string 类型内容

publish

void publish(@Header("mqtt_topic")
 String topic,
 String payload)

使用 自定义 Topic 和 Qos 发送数据

Parameters:

topic - 主题

payload - string 类型内容

publish

void publish(@Header("mqtt_topic")
 String topic,
 @Header("mqtt_qos")
 Integer qos,
 String payload)

使用 自定义 Topic 和 自定义 Qos 发送数据

Parameters:

topic - 主题

qos - Qos 等级

payload - string 类型内容

publish

void publish(@Header("mqtt_topic")
 String topic,
 @Header("mqtt_qos")
 Integer qos,
 byte[] payload)

使用 自定义 Topic 和 自定义 Qos 发送数据

Parameters:

topic - 主题

qos - Qos 等级

payload - byte[] 类型内容

publish

void publish(@Header("mqtt_topic")
 String topic,
 @Header("mqtt_responseTopic")
 String responseTopic,
 @Header("mqtt_correlationData")
 String correlationData,
 @Header("mqtt_qos")
 Integer qos,
 String payload)

发送请求响应的消息（MQTT v5新特性）

所以为 PUBLISH 报文新增了一个 对比数据（Correlation Data） 属性。

由于发布订阅模式本身的一些局限性，使用大于 0 的 QoS 也只能保证消息到达了对端而不是订阅端，如果发布消息时订阅端还未完成订阅，那么消息就会丢失，但发布方却无法得知。因此，对于一些投递要求比较严格的消息，可以通过请求响应来确认消息是否到达订阅端。

Parameters:

topic - 请求主题

responseTopic - 响应主题

correlationData - 对比数据

qos - Qos 等级

payload - 内容