初始化项目

云

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
71
72
73
74
75
76
77
78
79
package cn.iocoder.yudao.module.iot.gateway.protocol.mqtt.handler.upstream;
 
import cn.hutool.core.lang.Assert;
import cn.hutool.core.util.ArrayUtil;
import cn.iocoder.yudao.module.iot.core.mq.message.IotDeviceMessage;
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.vertx.mqtt.MqttEndpoint;
import lombok.extern.slf4j.Slf4j;
 
 
/**
 * IoT 网关 MQTT 上行消息处理器：处理业务消息（属性上报、事件上报等）
 *
 * @author 芋道源码
 */
@Slf4j
public class IotMqttUpstreamHandler extends IotMqttAbstractHandler {
 
    private final String serverId;
 
    public IotMqttUpstreamHandler(IotMqttConnectionManager connectionManager,
                                  IotDeviceMessageService deviceMessageService,
                                  String serverId) {
        super(connectionManager, deviceMessageService);
        this.serverId = serverId;
    }
 
    /**
     * 处理业务消息
     *
     * @param endpoint MQTT 连接端点
     * @param topic    主题
     * @param payload  消息内容
     */
    public void handleBusinessRequest(MqttEndpoint endpoint, String topic, byte[] payload) {
        String clientId = endpoint.clientIdentifier();
        try {
            // 1.1 基础检查
            if (ArrayUtil.isEmpty(payload)) {
                return;
            }
            // 1.2 解析主题，获取 productKey 和 deviceName
            String[] topicParts = topic.split("/");
            String productKey = ArrayUtil.get(topicParts, 2);
            String deviceName = ArrayUtil.get(topicParts, 3);
            Assert.notBlank(productKey, "产品 Key 不能为空");
            Assert.notBlank(deviceName, "设备名称不能为空");
            // 1.3 校验设备信息，防止伪造设备消息
            IotMqttConnectionManager.ConnectionInfo connectionInfo = connectionManager.getConnectionInfo(endpoint);
            Assert.notNull(connectionInfo, "无法获取连接信息");
            Assert.equals(productKey, connectionInfo.getProductKey(), "产品 Key 不匹配");
            Assert.equals(deviceName, connectionInfo.getDeviceName(), "设备名称不匹配");
            // 1.4 校验 topic 是否允许发布
            if (!IotMqttTopicUtils.isTopicPublishAllowed(topic, productKey, deviceName)) {
                log.warn("[handleBusinessRequest][topic 不允许发布，客户端 ID: {}，主题: {}]", clientId, topic);
                return;
            }
 
            // 2.1 反序列化消息
            IotDeviceMessage message = deviceMessageService.deserializeDeviceMessage(payload, productKey, deviceName);
            if (message == null) {
                log.warn("[handleBusinessRequest][消息解码失败，客户端 ID: {}，主题: {}]", clientId, topic);
                return;
            }
            // 2.2 标准化回复消息的 method（MQTT 协议中，设备回复消息的 method 会携带 _reply 后缀）
            IotMqttTopicUtils.normalizeReplyMethod(message);
 
            // 3. 处理业务消息
            deviceMessageService.sendDeviceMessage(message, productKey, deviceName, serverId);
            log.debug("[handleBusinessRequest][消息处理成功，客户端 ID: {}，主题: {}]", clientId, topic);
        } catch (Exception e) {
            log.error("[handleBusinessRequest][消息处理异常，客户端 ID: {}，主题: {}，错误: {}]",
                    clientId, topic, e.getMessage(), e);
        }
    }
 
}