fix: repair decompiled sources and add exhaustive documentation

- restore generic signatures, scoped variables and missing code from original bytecode
- remove decompiler artifacts and document classes, methods, fields and packages
- restore resources, add Batik/BouncyCastle dependencies and build/runtime docs
This commit is contained in:
rick committed 2026-11-16 17:28:23 +08:00
1 parent 9d7e42eda8
commit 10aa1829f5
346 files changed
+42404 -622

No files matched your search

@@ -70,9 +70,19 @@ import org.springframework.web.socket.WebSocketSession;
@Component
public class QueryHandler implements WebSocketHandler {
/**
* 站点服务;Spring 自动注入的依赖。
*
* 注解:{@code @Autowired}。
*/
@Autowired
private SiteService siteService;
/**
* 设备文件列表服务;Spring 自动注入的依赖。
*
* 注解:{@code @Autowired}。
*/
@Autowired
private DeviceFilesService deviceFilesService;
@@ -89,9 +99,19 @@ public class QueryHandler implements WebSocketHandler {
@Lazy
private DeviceReportService deviceReportService;
/**
* 用户服务;Spring 自动注入的依赖。
*
* 注解:{@code @Autowired}。
*/
@Autowired
private UserService userService;
/**
* 文件服务;Spring 自动注入的依赖。
*
* 注解:{@code @Autowired}。
*/
@Autowired
private FileService fileService;
@@ -103,6 +123,11 @@ public class QueryHandler implements WebSocketHandler {
@Autowired
private LogService logService;
/**
* 设置列表服务;Spring 自动注入的依赖。
*
* 注解:{@code @Autowired}。
*/
@Autowired
private SettingsService settingsService;
@@ -161,7 +186,7 @@ public class QueryHandler implements WebSocketHandler {
* @param message 抽象 WebSocket 消息载荷
*/
@Override
public void handleMessage(WebSocketSession session, WebSocketMessage message) throws Exception {
public void handleMessage(WebSocketSession session, WebSocketMessage<?> message) throws Exception {
MidmWebSocketSession midmSession = this.sessionManager.toMidmSocketSession(session, false);
if (midmSession != null) {
// 1. 刷新活跃时间戳(Heartbeat Timestamp)
@@ -249,6 +274,15 @@ public class QueryHandler implements WebSocketHandler {
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 {
}
@@ -394,6 +428,7 @@ public class QueryHandler implements WebSocketHandler {
}
}
}
break;
case CHECKIN:
default:
break;
@@ -518,8 +553,10 @@ public class QueryHandler implements WebSocketHandler {
case "data_usage":
// 记录移动数据用量统计
this.deviceReportService.saveDataUsage(device, feedback.getDataAsDbObject());
break;
}
}
break;
default:
}
}
@@ -585,6 +622,15 @@ public class QueryHandler implements WebSocketHandler {
}
}
/**
* 是否支持 WebSocket 分片消息。
*
* <p>MiDM 的报文由客户端一次性发送,服务端不启用 Spring 的 partial message 聚合,
* 因此固定返回 {@code false},避免额外缓存分片。
*
* 框架注解:{@code @Override}。
* @return 固定返回 {@code false}
*/
@Override
public boolean supportsPartialMessages() {
return false;
@@ -0,0 +1,12 @@
/**
* WebSocket 消息处理器:按 MIDM_REQUEST 分支处理设备上报。
*
* <p>本包主要类型:
* <ul>
* <li>{@link QueryHandler}</li>
* </ul>
*
* <p>阅读建议:结合本包内类的 Javadoc 与 {@code docs/CODE_WALKTHROUGH.md} 一起看,
* 先理解输入/输出,再跟踪 Service 与 MongoTemplate 的调用链。
*/
package com.midm.websocket.message;