package com.midm.websocket.message; import com.google.api.client.util.Strings; import com.google.gson.internal.LinkedTreeMap; import com.midm.model.device.Device; import com.midm.model.device.DeviceGroup; import com.midm.model.device.DeviceLicense; import com.midm.model.file.AppFile; import com.midm.model.file.OtaFile; import com.midm.model.message.MIDM_REQUEST; import com.midm.model.message.MidmPacket; import com.midm.model.message.MidmQuery; import com.midm.model.message.MidmResponse; import com.midm.model.org.Site; import com.midm.model.org.User; import com.midm.service.device.DeviceReportService; import com.midm.service.device.DeviceService; import com.midm.service.file.DeviceFilesService; import com.midm.service.file.FileService; import com.midm.service.log.LogService; import com.midm.service.message.MidmWebSocketSession; import com.midm.service.message.WebSocketSessionManager; import com.midm.service.org.SiteService; import com.midm.service.org.UserService; import com.midm.service.system.HostLicenseService; import com.midm.service.system.SettingsService; import com.mitac.cell.data.McDecompress; import com.mitac.cell.db.DbObject; import com.mitac.cell.utils.McDateTimeUtils; import com.mitac.cell.utils.McJsonUtils; import java.nio.ByteBuffer; import java.util.Date; import java.util.UUID; import org.joda.time.DateTime; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.annotation.Lazy; import org.springframework.stereotype.Component; import org.springframework.web.socket.BinaryMessage; import org.springframework.web.socket.CloseStatus; import org.springframework.web.socket.PongMessage; import org.springframework.web.socket.TextMessage; import org.springframework.web.socket.WebSocketHandler; import org.springframework.web.socket.WebSocketMessage; import org.springframework.web.socket.WebSocketSession; /** * ====================================================================================== * WebSocket 核心消息分发网关与连接生命周期处理器 (QueryHandler) * ====================================================================================== * *
【架构地位与核心职责】 * 1. 作为云端与边缘受控移动终端(Android Agent / DPC)及 Web 前端管理端的核心通信网关。 * 2. 连接生命周期管理: * - 建立连接认证与识别(区分是设备端 Device 还是管理用户 User); * - 动态配置单连接缓冲区阈值(避免高频遥测或截屏传输导致 OOM); * - 断开连接时清理 Session 路由表,触发设备离线状态变更。 * 3. 混合消息协议解析: * - 文本消息(TextMessage):处理轻量级心跳与控制命令 JSON; * - 二进制压缩消息(BinaryMessage):通过 {@link McDecompress} 解压 GZIP 报文,降低蜂窝网络流量开销; * - 心跳帧(PongMessage):维护自适应心跳时间戳,防连接假死。 * 4. 业务事件总线(onFeedback): * - ENROLL(设备注册与许可绑定):校验 SN 序列号、租户白名单、自动签发 License、归属分组; * - DEVICE_INFO(遥测与固件检测):更新设备运行属性,检测 OTA 固件镜像与 SKU 版本更新; * - RTC(WebRTC 信令转发):打通 Web 管理员与移动终端的远程桌面/远程控制数据通道; * - COMMAND / EXEC:下发即时控制指令(锁屏、重启、擦除、应用静默安装); * - DEVICE_LOG:受控端运行与排障审计日志远程上报。 * * @author MiDM Core Platform Team */ @Component public class QueryHandler implements WebSocketHandler { /** * 站点服务;Spring 自动注入的依赖。 * * 注解:{@code @Autowired}。 */ @Autowired private SiteService siteService; /** * 设备文件列表服务;Spring 自动注入的依赖。 * * 注解:{@code @Autowired}。 */ @Autowired private DeviceFilesService deviceFilesService; /** 会话管理器:维护全局在线 Session 拓扑映射与广播路由 */ @Autowired private WebSocketSessionManager sessionManager; /** 设备核心服务:处理设备注册、更新、分组与授权逻辑 */ @Autowired private DeviceService deviceService; /** 设备遥测与监控报表服务(Lazy 延迟加载,防止循环依赖注入) */ @Autowired @Lazy private DeviceReportService deviceReportService; /** * 用户服务;Spring 自动注入的依赖。 * * 注解:{@code @Autowired}。 */ @Autowired private UserService userService; /** * 文件服务;Spring 自动注入的依赖。 * * 注解:{@code @Autowired}。 */ @Autowired private FileService fileService; /** 系统授权服务:单租户 / 多租户 License 规则校验 */ @Autowired private HostLicenseService hostLicenseService; /** 审计日志服务:记录设备注册、策略变更等关键安全事件 */ @Autowired private LogService logService; /** * 设置列表服务;Spring 自动注入的依赖。 * * 注解:{@code @Autowired}。 */ @Autowired private SettingsService settingsService; /** * WebSocket 连接建立成功后的回调(握手完成) * * @param session 原生 WebSocket 会话对象 */ @Override public void afterConnectionEstablished(WebSocketSession session) { try { // 1. 将原生会话包装为系统定制的 MidmWebSocketSession,提取握手 Header/Query 中的鉴权凭证 MidmWebSocketSession midmSession = this.sessionManager.toMidmSocketSession(session, true); if (midmSession != null) { // 2. 根据系统配置动态设置二进制与文本消息的最大缓冲区容量(防内存溢出) int bufferSize = this.settingsService.webSocketBufferSize(); session.setBinaryMessageSizeLimit(bufferSize); session.setTextMessageSizeLimit(bufferSize); // 3. 区分连接主体身份:如果是设备端连接,触发上线事件;如果是后台管理员,注册用户会话 if (midmSession.getDevice() != null) { this.sessionManager.onConnected(midmSession); } else { User user = midmSession.getUser(); if (user != null) { this.sessionManager.register(midmSession); } } } } catch (Exception e) { e.printStackTrace(); } } /** * WebSocket 连接关闭回调(正常断开或网络异常中止) * * @param session 原生 WebSocket 会话对象 * @param status 断开状态码与原因 */ @Override public void afterConnectionClosed(WebSocketSession session, CloseStatus status) { try { if (this.sessionManager != null) { // 从全局路由表中注销该 Session,标记设备为离线状态并广播通知关注该设备的管理前端 this.sessionManager.onDisconnected(session, status); } } catch (Exception var4) { } } /** * WebSocket 消息接收总入口 * * @param session 原生会话 * @param message 抽象 WebSocket 消息载荷 */ @Override public void handleMessage(WebSocketSession session, WebSocketMessage> message) throws Exception { MidmWebSocketSession midmSession = this.sessionManager.toMidmSocketSession(session, false); if (midmSession != null) { // 1. 刷新活跃时间戳(Heartbeat Timestamp) midmSession.updatePongTimeStamp(); // 2. 流量统计:如果租户开启了移动蜂窝流量采集,根据阈值触发流量上报 if (midmSession.getDevice() != null) { Site site = this.siteService.findByUuid(midmSession.getSiteUuid()); if (site != null && site.collectDataUsage() && midmSession.needToUpdateDataUsage()) { this.deviceReportService.updateDataUsage(midmSession.getDevice(), (Date)null); } } // 3. 根据消息协议帧类型进行分别处理 if (message instanceof PongMessage) { if (session.isOpen()) { midmSession.pong(); this.handlePongMessage(midmSession, (PongMessage)message); } else { midmSession.close(CloseStatus.SESSION_NOT_RELIABLE); } } else if (message instanceof TextMessage) { this.handleTextMessage(midmSession, (TextMessage)message); } else if (message instanceof BinaryMessage) { this.handleBinaryMessage(midmSession, (BinaryMessage)message); } } } /** * 处理文本格式消息(JSON 报文或轻量心跳字符串) * * @param session 包装会话 * @param message 文本消息帧 */ public void handleTextMessage(MidmWebSocketSession session, TextMessage message) { String payload = (String)message.getPayload(); if (!Strings.isNullOrEmpty(payload)) { if (payload.equals("ping")) { // 轻量文本心跳处理 this.sessionManager.onPing(session); } else { // 反序列化为统一定义的业务数据包 MidmPacket MidmPacket packet = (MidmPacket)McJsonUtils.toObject(payload, MidmPacket.class); if (packet != null) { this.sessionManager.sendMessage(packet); } } } } /** * 【IoT 网络优化亮点】处理二进制压缩消息帧 * *
移动设备为了节省 4G/5G 流量并提高吞吐量,将大量遥测数据(如设备所有已安装应用、电池历史等)
* 在端侧经过 Deflate/GZIP 压缩后传输。此处进行高性能内存解压后再转为业务包。
*
* @param session 包装会话
* @param message 二进制消息帧
*/
public void handleBinaryMessage(MidmWebSocketSession session, BinaryMessage message) {
ByteBuffer buffer = (ByteBuffer)message.getPayload();
if (buffer != null) {
// 调用自研压缩工具类进行数据解压
byte[] decompressed = McDecompress.decompress(buffer.asReadOnlyBuffer());
if (decompressed != null && decompressed.length != 0) {
MidmPacket packet = (MidmPacket)McJsonUtils.toObject(decompressed, MidmPacket.class);
if (packet != null) {
String request = packet.getQuery().getRequest();
if (!Strings.isNullOrEmpty(request) && request.equals("ping")) {
this.sessionManager.onPing(session);
} else if (packet.getFeedback() != null) {
// 转发给业务反馈分发总线
this.onFeedback(session, packet);
}
}
}
}
}
/**
* 处理客户端响应的 Pong 心跳帧
*/
protected void handlePongMessage(MidmWebSocketSession session, PongMessage message) {
this.sessionManager.onPong(session);
}
/**
* 处理Transport错误。
*
* 框架注解:{@code @Override}。
*
* @param session WebSocket 会话({@code WebSocketSession})
* @param exception 参数 {@code exception}({@code Throwable})
* @throws Exception 当 Exception 条件不满足或底层调用失败时抛出。
*/
@Override
public void handleTransportError(WebSocketSession session, Throwable exception) throws Exception {
}
/**
* 【核心业务路由器】处理边缘终端返回的各类操作响应(Feedback)
*
* @param midmSession 触发该事件的设备连接会话
* @param packet 包含 Query 原请求信息与 Feedback 执行结果的数据包
*/
private void onFeedback(MidmWebSocketSession midmSession, MidmPacket packet) {
MidmQuery query = packet.getQuery();
MidmResponse feedback = packet.getFeedback();
String serialNo = midmSession.serialNo();
switch (MIDM_REQUEST.get(query.getCode())) {
case ENROLL:
// -------------------------------------------------------------
// 1. 设备注册与入网接入(Device Enrollment)
// -------------------------------------------------------------
if (Strings.isNullOrEmpty(serialNo)) {
// 必须包含出厂硬件唯一序列号 SN
midmSession.sendFeedback(461, "No serial no. defined.", (Object)null);
midmSession.close(CloseStatus.NOT_ACCEPTABLE);
} else {
Device device = (Device)McJsonUtils.toObject(McJsonUtils.toJson(feedback.getData()), Device.class);
Device existDevice = this.deviceService.findBySerialNo(midmSession.serialNo());
UUID siteUuid = existDevice == null ? device.getSiteUuid() : existDevice.getSiteUuid();
// 若设备更换了序列号,同步更新索引
if (existDevice != null && !serialNo.equals(existDevice.getSerialNo())) {
existDevice.setSerialNo(serialNo);
this.deviceService.updateSerialNo(existDevice, serialNo);
existDevice = this.deviceService.findBySerialNo(serialNo);
}
Site currentSite = this.siteService.findByUuid(siteUuid);
if (currentSite == null) {
midmSession.sendFeedback(451, "No site available.", (Object)null);
midmSession.close(CloseStatus.NOT_ACCEPTABLE);
} else if (currentSite.limitRegisteredDeviceOnly() && existDevice == null) {
// 开启了安全白名单:只允许后台预导入的设备接入
midmSession.sendFeedback(463, "Enrollement rejected due to un-registered device.", (Object)null);
midmSession.close(CloseStatus.NOT_ACCEPTABLE);
} else {
String siteModel = currentSite.getModel();
boolean isSelfEnroll = midmSession.selfEnroll();
if (existDevice == null) {
// 新设备首次注册
device.init();
if (device.getGroupUuid() != null) {
DeviceGroup group = this.deviceService.findDeviceGroup(device.getGroupUuid());
device.setDeviceGroup(group);
}
// 自动签发并激活试用/指定 License 许可
if (!this.hostLicenseService.isStandalone() && (siteModel == null || siteModel.equals("midm"))) {
DeviceLicense license = this.deviceService.setTrialLicense(device);
device.setLicense(license);
String licenseIdName = midmSession.licenseId();
if (!Strings.isNullOrEmpty(licenseIdName)) {
boolean autoRenew = midmSession.autoRenew();
boolean renewToSameModel = midmSession.renewToSameModel();
license = this.deviceService.setLicense(device, licenseIdName, autoRenew, renewToSameModel);
if (license != null) {
device.setLicense(license);
}
}
this.deviceService.activateLicense(license);
}
existDevice = device;
} else {
// 存量设备重新连接/注册
if (!device.getProfile().isEmpty()) {
existDevice.getProfile().putAll(device.getProfile());
}
if (midmSession.ifExistsOption().option != 0) {
// 校验 License 是否过期
if (!this.hostLicenseService.isStandalone() && existDevice.getLicense().isExpired()) {
midmSession.sendFeedback(115, "Device license expired.", (Object)null);
midmSession.close(CloseStatus.NOT_ACCEPTABLE);
}
if (isSelfEnroll && !device.isAssociated() && device.getGroupUuid() != null) {
DeviceGroup group = this.deviceService.findDeviceGroup(device.getGroupUuid());
existDevice.setDeviceGroup(group);
}
existDevice.setUpdated();
// 关联设备所属企业员工(User Owner)
Object jOwner = device.getProfile("owner");
if (jOwner != null) {
LinkedTreeMap MiDM 的报文由客户端一次性发送,服务端不启用 Spring 的 partial message 聚合,
* 因此固定返回 {@code false},避免额外缓存分片。
*
* 框架注解:{@code @Override}。
* @return 固定返回 {@code false}
*/
@Override
public boolean supportsPartialMessages() {
return false;
}
}