2026-06-26 20b96473f2520590a0dca6b775b81e3ea06a77a0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
package cn.iocoder.yudao.module.iot.gateway.protocol.mqtt.handler.downstream;
 
import cn.hutool.core.lang.Assert;
import cn.iocoder.yudao.module.iot.core.mq.message.IotDeviceMessage;
import cn.iocoder.yudao.module.iot.core.util.IotDeviceMessageUtils;
import cn.iocoder.yudao.module.iot.gateway.protocol.mqtt.manager.IotMqttConnectionManager;
import cn.iocoder.yudao.module.iot.gateway.service.device.message.IotDeviceMessageService;
import cn.iocoder.yudao.module.iot.gateway.util.IotMqttTopicUtils;
import io.netty.handler.codec.mqtt.MqttQoS;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
 
/**
 * IoT 网关 MQTT 协议:下行消息处理器
 *
 * @author 芋道源码
 */
@Slf4j
@RequiredArgsConstructor
public class IotMqttDownstreamHandler {
 
    private final IotDeviceMessageService deviceMessageService;
 
    private final IotMqttConnectionManager connectionManager;
 
    /**
     * 处理下行消息
     *
     * @param message 设备消息
     */
    public void handle(IotDeviceMessage message) {
        try {
            log.info("[handle][处理下行消息,设备 ID: {},方法: {},消息 ID: {}]",
                    message.getDeviceId(), message.getMethod(), message.getId());
 
            // 1. 检查设备连接
            IotMqttConnectionManager.ConnectionInfo connectionInfo = connectionManager.getConnectionInfoByDeviceId(
                    message.getDeviceId());
            if (connectionInfo == null) {
                log.warn("[handle][连接信息不存在,设备 ID: {},方法: {},消息 ID: {}]",
                        message.getDeviceId(), message.getMethod(), message.getId());
                return;
            }
 
            // 2.1 序列化消息
            byte[] payload = deviceMessageService.serializeDeviceMessage(message, connectionInfo.getProductKey(),
                    connectionInfo.getDeviceName());
            Assert.isTrue(payload != null && payload.length > 0, "消息编码结果不能为空");
            // 2.2 构建主题
            Assert.notBlank(message.getMethod(), "消息方法不能为空");
            boolean isReply = IotDeviceMessageUtils.isReplyMessage(message);
            String topic = IotMqttTopicUtils.buildTopicByMethod(message.getMethod(), connectionInfo.getProductKey(),
                    connectionInfo.getDeviceName(), isReply);
            Assert.notBlank(topic, "主题不能为空");
 
            // 3. 发送到设备
            boolean success = connectionManager.sendToDevice(message.getDeviceId(), topic, payload,
                    MqttQoS.AT_LEAST_ONCE.value(), false);
            if (!success) {
                throw new RuntimeException("下行消息发送失败");
            }
            log.info("[handle][下行消息发送成功,设备 ID: {},方法: {},消息 ID: {},主题: {},数据长度: {} 字节]",
                    message.getDeviceId(), message.getMethod(), message.getId(), topic, payload.length);
        } catch (Exception e) {
            log.error("[handle][处理下行消息失败,设备 ID: {},方法: {},消息内容: {}]",
                    message.getDeviceId(), message.getMethod(), message, e);
        }
    }
 
}