Files
mdm/docs/CODE_WALKTHROUGH.md
T
rick 10aa1829f5 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
2026-11-16 17:28:23 +08:00

457 lines
22 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# MiDM 源码学习指南(CODE WALKTHROUGH)
> 目标:把反编译出来的 Java 代码变成一套可以按图索骥学习的工程。
> 本文件讲**架构与调用链**;每个类/方法/字段的细节看源码里的 Javadoc
>(本次已补全 286 个类型、3,989 个方法、1,733 个字段的注释)。
---
## 0. 推荐阅读顺序
1. 先读本文件第 1~4 节,建立“端 → 云 → Mongo → 管理后台”的整体地图。
2. 读 <code>com.midm.model</code>:先看 <code>GeneralProfile</code>、<code>Device</code>、<code>DeviceProfile</code>、<code>Site</code>、<code>User</code>。
3. 读 <code>com.midm.service.BaseService</code> 与一个具体 Service(推荐 <code>DeviceService</code>)。
4. 读 <code>com.midm.websocket.message.QueryHandler</code>:这是设备协议的总入口。
5. 读 <code>com.midm.webservice.device.DeviceApi</code> / <code>DeviceProfileApi</code>:管理端 REST 入口。
6. 最后读文件/报表/云存储/安全等横向能力。
---
## 1. 系统全景
MiDM 是一套面向工业手持终端、车载平板、POS/医疗设备的 MDM/EMM 平台:
~~~text
Android 设备 (DPC/MDM Agent)
│ WebSocket /query(文本 JSON、二进制 Deflate)
│ REST /dpc/*、/file/*(下载、二维码、APK/OTA)
▼
Spring Boot 2.7 (WAR)
├─ QueryHandler ── WebSocketSessionManager ── DeviceService / ProfileService / BatteryService
├─ Controller / WebService ── UserService / SiteService / FileService / ReportService
├─ MongoTemplate / Repository ── MongoDB (db_midm)
└─ CloudStorageService ── AWS S3 / Azure Blob / GCP Storage
~~~
管理后台(Thymeleaf + 静态前端)通过 REST/JSON 与 WebSocket 同时接入;
设备端主要走 WebSocket 长连接,少量文件下载走 HTTP。
技术栈:Java 11 目标字节码、Spring Boot 2.7.15、Spring Security 5.7、
Spring Data MongoDB 3.4、Thymeleaf、POI、Flying Saucer、ZXing、OkHttp、
AWS SDK v1/v2、Azure SDK、Google Cloud Storage、Batik。
---
## 2. 目录地图
| 包 | 作用 | 先看谁 |
| --- | --- | --- |
| <code>com.midm</code> | 启动入口 | <code>MainApplication</code> |
| <code>com.midm.app</code> | Mongo/Security/WebSocket/Locale/启动初始化 | <code>DbConfig</code>、<code>SecurityConfig</code>、<code>DbInitialize</code>、<code>StartupKeeper</code> |
| <code>com.midm.app.converter</code> | 请求参数 → 对象转换 | <code>DateConverter</code>、<code>JsonObjectConverter</code> |
| <code>com.midm.constant</code> | 常量、集合名、协议码 | <code>MidmConst</code>、<code>PropertyConst</code> |
| <code>com.midm.controller</code> | 页面路由(Thymeleaf) | <code>HomeController</code>、<code>DeviceController</code> |
| <code>com.midm.controller.lib</code> | 图片/文件下载 | <code>FilesController</code>、<code>StoreController</code> |
| <code>com.midm.dpc</code> | Android Enterprise 零接触 | <code>DpcController</code>、<code>DpcModel</code> |
| <code>com.midm.model</code> | 领域模型 / Mongo 文档 | <code>GeneralProfile</code>、<code>Device</code>、<code>DeviceProfile</code> |
| <code>com.midm.repository</code> | Spring Data Repository | <code>DeviceLicenseRepository</code> |
| <code>com.midm.security</code> | 认证主体 | <code>UserPrincipal</code> |
| <code>com.midm.service</code> | 业务服务 | <code>BaseService</code>、<code>DeviceService</code>、<code>ProfileService</code> |
| <code>com.midm.webservice</code> | 管理端/设备端 REST API | <code>DeviceApi</code>、<code>DeviceProfileApi</code>、<code>UserApi</code> |
| <code>com.midm.websocket</code> | WebSocket 网关与协议处理 | <code>QueryHandler</code> |
| <code>com.mitac.cell</code> | 通用基础库 | <code>DbObject</code>、<code>McJsonUtils</code>、<code>McFile</code>、<code>McTextEncryptor</code> |
---
## 3. 启动与配置链路
### 3.1 启动入口
<code>MainApplication</code>:
- <code>@SpringBootApplication(scanBasePackages = "com.midm")</code>;
- 继承 <code>SpringBootServletInitializer</code>,既支持 <code>java -jar</code> 也支持外置 Tomcat;
- <code>@EnableScheduling</code> 打开定时任务;
- <code>restart()</code> 在非守护线程中关闭并重建 Spring 上下文,用于运行期热重启。
### 3.2 外部配置
<code>PropertiesConfig</code> 会强制读取:
~~~text
C:\ProgramData\MiDM\midm.properties
~~~
目录或文件不存在时,<code>PropertySourcesPlaceholderConfigurer</code> 会抛
<code>FileNotFoundException</code>,应用直接启动失败。本地开发建议内容:
~~~properties
mongo.uri=
mongo.host=127.0.0.1
mongo.port=27017
mongo.dbname=db_midm
mongo.replica_set=
~~~
<code>application.properties</code> 负责日志级别、Session Cookie、Tomcat access log、
Thymeleaf 缓存、静态资源缓存等 Spring Boot 配置;Mongo 连接参数集中在
<code>DbConfig</code> 的 <code>@Value</code> 字段。
### 3.3 Mongo 连接池
<code>DbConfig.getConnectiontString()</code> 根据 <code>mongo.uri</code> / <code>mongo.host</code>
动态拼装 <code>ConnectionString</code>:
- 多节点时拆分逗号分隔的 host,补齐默认端口;
- 强制 <code>w=majority</code>、<code>retryWrites=true</code>、<code>uuidRepresentation=javaLegacy</code>;
- 按配置补齐 <code>maxPoolSize</code>、<code>connectTimeoutMS</code>、<code>maxIdleTimeMS</code>、
<code>waitqueuetimeoutms</code>、<code>ssl</code>、<code>replicaSet</code>;
- <code>fixDb()</code> 在启动时做索引自愈(删除低效单字段索引,确保复合索引生效)。
> 注意:单机 MongoDB 要把 <code>mongo.replica_set</code> 置空;副本集才填 <code>rs0</code> 并执行
> <code>rs.initiate()</code>。
### 3.4 初始化与启动钩子
- <code>DbInitialize</code>:首次启动时建集合/索引、修复历史数据、补默认设置。
- <code>StartupKeeper</code>:监听 <code>ContextRefreshedEvent</code>,加载系统设置、恢复同步、
校验 License、加载语言与帮助消息、初始化设备状态、清理孤儿数据、安排通知任务。
---
## 4. 领域模型与 MongoDB
### 4.1 公共基类 <code>GeneralProfile</code>
大部分业务对象继承 <code>com.midm.model.GeneralProfile</code>:
| 字段 | 作用 |
| --- | --- |
| <code>uuid</code> | 业务主键(<code>@Id</code>),全系统统一用 UUID |
| <code>created</code> / <code>updated</code> | 创建/更新时间 |
| <code>profile</code> | <code>DbObject</code> 扩展属性包,承载厂商/硬件/软件等可变字段 |
| <code>enabled</code> | 通用启用状态 |
<code>DbObject</code> 继承 <code>org.bson.Document</code>,提供 <code>getString/getBoolean/getList/getDbObject</code>
等便捷方法,避免到处强转。
### 4.2 常用注解
| 注解 | 含义 |
| --- | --- |
| <code>@Document</code> | 映射为 MongoDB 集合 |
| <code>@Id</code> | 文档主键 |
| <code>@Indexed</code> | 建索引,常用于查询条件 |
| <code>@Field("x")</code> | 指定 Mongo 字段名 |
| <code>@Transient</code> | 不持久化,仅运行时 |
| <code>@DBRef</code> | 引用其他文档(慎用,查询成本高) |
| <code>@Expose(serialize=false)</code> | Gson 序列化时排除(如密码) |
### 4.3 核心集合(按业务)
| 领域 | 主要类 | 说明 |
| --- | --- | --- |
| 设备 | <code>Device</code>、<code>DeviceApps</code>、<code>DeviceGroup</code>、<code>DeviceNote</code> | 设备档案、已装应用、分组树、备注 |
| 策略 | <code>DeviceProfile</code>、<code>ProfileApps</code>、<code>ProfileScope</code> | 配置档案、应用/文件/OTA 项、作用域 |
| 组织 | <code>Site</code>、<code>User</code>、<code>SiteInfo</code>、<code>UserGroup</code> | 多租户站点、账号、站点成员、用户组 |
| 授权 | <code>DeviceLicense</code>、<code>SiteLicense</code>、<code>LicenseModel</code>、<code>HostLicense</code> | 设备/站点/主机 License |
| 文件 | <code>BaseFile</code>、<code>AppFile</code>、<code>OtaFile</code>、<code>StoreAppFile</code> | APK/OTA/普通文件/商店文件 |
| 遥测 | <code>Battery</code>、<code>BatteryLog</code>、<code>DataUsage</code>、<code>DeviceReport</code> | 电池健康、流量、设备报表 |
| 审计 | <code>MidmLog</code>、<code>DeviceLog</code> | 操作/设备日志 |
| 系统 | <code>SystemSetting</code>、<code>Locale</code>、<code>HelpMessage</code>、<code>NewsMessage</code> | 设置、语言、帮助、通知 |
| 商店 | <code>StoreApp</code>、<code>StoreWebApp</code>、<code>AppReleaseNote</code> | 应用商店/WebApp/发布说明 |
阅读实体时先看字段注释和注解,再看对应 Service 如何构造 <code>Criteria</code>。
---
## 5. Web 层与安全
### 5.1 两类入口
- <code>com.midm.controller</code>:返回 Thymeleaf 视图名,服务管理后台页面;
- <code>com.midm.webservice</code>:<code>@RestController</code>/JSON,服务前端 AJAX 与设备/第三方 API。
统一响应封装是 <code>MidmResponse</code>(code/message/data),异常由
<code>ExceptionController</code> 收敛。
### 5.2 认证与授权
- <code>SecurityConfig</code> 定义过滤器链、登录页、静态资源放行、CSRF/Headers;
- <code>BasicAuthInterceptor</code> 处理 Basic/Token 头;
- <code>UserPrincipal</code> 把 <code>User</code> 包装成 Spring Security 主体;
- <code>UserRole</code> 定义角色常量(SUPERVISOR、DEVICE_MANAGER、PROFILE_MANAGER 等);
- <code>UserService.authorizedUser(authentication, accessToken)</code> 是各 API 的统一鉴权入口;
- <code>user.canHandle(siteUuid, roles)</code> 做站点级权限判断。
### 5.3 典型 REST 调用链
<code>DeviceApi.findDevices()</code> → <code>UserService.authorizedUser()</code> → 站点校验 →
<code>DeviceService.findDevices()</code> → <code>BaseService.findByPage()</code> → MongoTemplate。
---
## 6. WebSocket 设备通道(重点)
### 6.1 端点与握手
<code>WebSocketConfig</code> 把 <code>/query</code> 注册到 <code>QueryHandler</code>,允许跨域。
握手完成后 <code>afterConnectionEstablished</code>:
1. <code>WebSocketSessionManager.toMidmSocketSession(session, true)</code> 从 Header/Query
解析设备序列号或用户 Token,包装成 <code>MidmWebSocketSession</code>;
2. 按配置设置文本/二进制最大缓冲;
3. 设备连接走 <code>onConnected</code>,管理端用户连接走 <code>register</code>。
### 6.2 报文模型
<code>MidmPacket</code> 是统一报文:
- <code>query</code>:请求(<code>MidmQuery</code>,含 code/request/params);
- <code>feedback</code>:响应(<code>MidmResponse</code>,含 code/message/data);
- <code>uuid</code> / <code>queryUuid</code> / <code>recieverUuid</code>:路由与幂等;
- 支持 <code>toTextMessage()</code> / <code>toBinaryMessage()</code>,二进制路径用 <code>McCompress</code> 压缩。
<code>MIDM_REQUEST</code> 定义协议码,例如:
| code | 枚举 | 含义 |
| --- | --- | --- |
| 99 | <code>PING</code> | 心跳 |
| 100 | <code>CONNECT</code> | 建连 |
| 104 | <code>ENROLL</code> | 设备注册 |
| 105 | <code>DEVICE_INFO</code> | 设备信息/遥测上报 |
| 131/132 | <code>UPDATE_PROFILE</code> / <code>UPDATE_ALL_PROFILES</code> | 策略下发/全量同步 |
| 136 | <code>REMOVE_PROFILE</code> | 移除策略 |
| 200 | <code>COMMAND</code> | 远程指令 |
| 210 | <code>QUERY</code> | 查询设备信息 |
| 400 | <code>RTC</code> | 远程协助/WebRTC 信令 |
### 6.3 消息分发
<code>QueryHandler.handleMessage</code>:
1. 刷新 pong 时间戳;
2. 若租户开启流量采集,按阈值触发 <code>updateDataUsage</code>;
3. 按帧类型分派:
- <code>PongMessage</code> → <code>onPong</code>;
- <code>TextMessage</code> → <code>handleTextMessage</code>(<code>"ping"</code> 或 JSON <code>MidmPacket</code>);
- <code>BinaryMessage</code> → <code>McDecompress</code> 解压后按 <code>feedback</code>/ping 处理。
<code>onFeedback</code> 是业务总路由:<code>ENROLL</code> 注册、<code>DEVICE_INFO</code> 更新设备、
<code>UPDATE_PROFILE</code>/命令回执、<code>RTC</code> 信令等。
### 6.4 会话管理
<code>WebSocketSessionManager</code> 维护:
- <code>deviceSessions</code>:设备 UUID → <code>MidmWebSocketSession</code>;
- <code>userSessions</code>:用户 UUID → <code>UserSocketSessions</code>;
- 心跳 ping/pong、在线状态广播、断线清理;
- <code>ReconnectMonitor</code>:滑动窗口统计重连频率,异常时 block,防止弱网重连风暴。
### 6.5 设备注册(ENROLL)链路
<code>QueryHandler.onFeedback</code> 的 <code>ENROLL</code> 分支:
1. 校验序列号;找不到站点/白名单不允许则回 451/463/461 并关闭;
2. <code>DeviceService.register()</code>:初始化设备、绑定分组、所有者、站点;
3. License 激活/试用;
4. 审计日志 <code>LogService.saveDeviceLog</code>;
5. 注册全局 Session,下发 111 + 精简设备配置;
6. License 过期则回 115 并关闭。
---
## 7. 设备生命周期与策略
### 7.1 设备
<code>DeviceService</code> 是设备中枢:
- 注册/保存/批量导入:<code>register</code>、<code>save</code>、<code>saveDevices</code>;
- 查询:<code>findBySerialNo</code>、<code>findDeviceByUuid</code>、<code>findDevices</code>(分页/过滤);
- 分组:<code>findGroupFamily</code>、<code>findChildGroups</code>、<code>findAllDevicesInGroup</code>;
- 删除/退役:<code>delete</code>、<code>retire</code>、<code>deleteBySite</code>;
- License:<code>setTrialLicense</code>、<code>activateLicense</code>、<code>renewLicense</code>;
- OTA 回调:<code>systemImageUpdated</code>、<code>regionImageUpdated</code>。
### 7.2 策略(Profile)
<code>ProfileService</code> 负责配置档案:
- CRUD:<code>save</code>、<code>find</code>、<code>delete</code>、<code>findProfiles</code>;
- 作用域:<code>updateScope</code>、<code>unscope</code>、<code>isDeviceScoped</code>、<code>isGroupScoped</code>;
- 下发:<code>notifyToSync</code> 给设备发 WebSocket 通知;
- 应用状态:<code>isProfileApplied</code>、<code>profileStatesByDevice</code>;
- 冲突解决:<code>ProfileAdvisor</code> 计算应用/设置/OTA 冲突,决定最终下发项。
### 7.3 License
- <code>DeviceLicense</code>:设备级,含 <code>licenseModel</code>、<code>expiry</code>、<code>activationCount</code>;
- <code>SiteLicense</code>:站点级采购/续费;
- <code>LicenseModel</code>:型号/周期/最大激活数;
- <code>HostLicenseService</code>:主机级 License 校验(单机/多租户模式)。
---
## 8. 文件与云存储
### 8.1 文件模型
- <code>BaseFile</code>:文件名、大小、校验和、站点、分类;
- <code>AppFile</code>:APK 包名、版本号、minSdk、签名证书;
- <code>OtaFile</code>:固件 build date、SKU、区域、系统/区域镜像标记。
### 8.2 路径规则
<code>FileService</code> 统一生成路径:<code>getFilePath</code>、<code>getDeviceFilePath</code>、
<code>getSiteFilePath</code>、<code>getMustFolderFilePath</code>。上传/下载/删除都走这里,
避免路径拼接散落各处。
### 8.3 多云策略
<code>CloudStorageService</code> 根据 <code>cloud.storage</code> 设置选择:
- <code>AwsS3</code>
- <code>AzureBlob</code>
- <code>GoogleCloudStorage</code>
统一接口:<code>upload</code>、<code>download/getUrl</code>、<code>exists</code>、<code>delete</code>、<code>list</code>、
<code>updateMetaInfo</code>、<code>refreshClient</code>。大文件用预签名 URL 让设备直连云存储,
服务端只负责签发和元数据。
### 8.4 APK 签名
<code>StoreAppService.sign()</code> 调用资源里的 <code>apksigner/apksigner.jar</code>,
用 keystore 对 APK 重签名,并记录证书 MD5/版本信息。
---
## 9. 报表、邮件与模板
### 9.1 报表
<code>ReportService</code> 基于 POI 的 <code>ExcelWriter</code> 生成三类报表:
- <code>generateDeviceReport</code>:设备清单/状态/流量/电池;
- <code>generateProfileReport</code>:策略应用情况;
- <code>generateSiteReport</code>:站点/License/设备分布。
模板在 <code>src/main/resources/report/*.xlsx</code>,生成后保存为 <code>SiteFile</code>,
可下载或邮件发送。
### 9.2 PDF
<code>com.mitac.cell.doc.HtmlToPdf</code> 用 Flying Saucer + iText 把 HTML 转 PDF。
### 9.3 邮件与模板
- <code>EmailService</code>:发送密码重置、License、报表等邮件;
- <code>TemplateService</code>:从 Mongo/资源加载模板;
- <code>McMailSender</code>:封装 JavaMail,支持抄送/密送/附件;
- <code>EmailTemplateResolver</code>:Thymeleaf 模板解析。
---
## 10. 异步、定时与并发
- <code>AsyncConfig</code>:配置 <code>ThreadPoolTaskExecutor</code>;
- <code>@Async</code>:报表生成、邮件发送、日志等不阻塞请求;
- <code>@Scheduled</code> / <code>ScheduledTaskService</code>:设备离线检查、报表过期、通知;
- <code>ReconnectMonitor</code>:滑动窗口 + 定时 unblock;
- <code>synchronized</code> / <code>ConcurrentHashMap</code>:会话表、缓存等共享状态。
读并发代码时先找“共享字段”,再看锁粒度和任务调度器。
---
## 11. 安全细节
- 设备密钥:<code>DeviceKeyService</code> 生成/保存 RSA 公私钥;
- 请求验签:<code>ExternalApiService.doRequestRsaIsValid</code> 用 RSA-OAEP 解密设备密文;
- 密码:BCrypt(<code>PasswordEncoder</code>);
- API Token:<code>UserToken</code> / <code>accessToken</code>,一次性令牌用后删除;
- 文件下载:<code>FilesController</code> 校验用户站点归属,防越权下载;
- 安全头/CSRF/Session Cookie:<code>SecurityConfig</code> + <code>application.properties</code>。
---
## 12. 构建、运行与排错
### 12.1 本机环境
- JDK 18(编译目标 11);
- Maven 3.9.9;
- MongoDB 7.0.14(单机);
- <code>C:\ProgramData\MiDM\midm.properties</code> 必须存在。
### 12.2 命令
~~~powershell
mvn clean package -DskipTests
java -jar target\midm-1.1.1.12.war
~~~
### 12.3 常见错误
| 现象 | 原因 | 处理 |
| --- | --- | --- |
| <code>FileNotFoundException: c:\ProgramData\MiDM\midm.properties</code> | 运行配置缺失 | 创建目录和文件 |
| <code>replicaSet=rs0</code> 连接失败 | 单机 Mongo 却配了副本集 | <code>mongo.replica_set=</code> 置空 |
| 端口占用 | 8080 被占用 | <code>--server.port=18081</code> |
| 登录页 404 | 访问了错误路径 | 用 <code>/</code>,不是 <code>/login</code> |
| 生成报表/邮件失败 | 模板/邮箱配置缺失 | 看 <code>SettingsService</code> 与运行日志 |
---
## 13. 建议的学习路线
| 天 | 目标 | 代码 |
| --- | --- | --- |
| Day 1 | 跑起来 + 模型 | <code>MainApplication</code> → <code>GeneralProfile</code> → <code>Device</code> → <code>Site</code> → <code>User</code> |
| Day 2 | 通用 CRUD/分页 | <code>BaseService</code> → <code>DeviceService</code> 的 find/save/delete |
| Day 3 | 设备协议 | <code>WebSocketConfig</code> → <code>QueryHandler</code> → <code>WebSocketSessionManager</code> |
| Day 4 | 策略与 License | <code>ProfileService</code> → <code>ProfileAdvisor</code> → <code>DeviceLicense</code> |
| Day 5 | 文件/报表/云存储 | <code>FileService</code> → <code>CloudStorageService</code> → <code>ReportService</code> |
| Day 6 | 安全/定时任务 | <code>SecurityConfig</code> → <code>UserPrincipal</code> → <code>ScheduledTaskService</code> |
练习建议:
1. 新增一个只读 API:<code>GET /api/device/count</code>,走 <code>DeviceService.count</code>;
2. 给 <code>Device</code> 增加一个 <code>@Indexed</code> 字段,观察 <code>DbInitialize</code> 索引;
3. 在 <code>MIDM_REQUEST</code> 增加一个协议码,在 <code>onFeedback</code> 加分支;
4. 给 <code>ProfileService</code> 增加一个“按名称模糊查询”的方法并写 Javadoc。
---
## 14. 代码索引(功能 → 类)
| 功能 | 入口 | 核心实现 |
| --- | --- | --- |
| 启动 | <code>MainApplication</code> | <code>DbConfig</code>、<code>DbInitialize</code>、<code>StartupKeeper</code> |
| 登录/鉴权 | <code>UserApi</code> | <code>UserService</code>、<code>SecurityConfig</code>、<code>UserPrincipal</code> |
| 设备列表/详情 | <code>DeviceApi</code> | <code>DeviceService</code>、<code>BaseService</code> |
| 设备注册 | <code>QueryHandler.ENROLL</code> | <code>DeviceService.register</code>、<code>WebSocketSessionManager</code> |
| 策略管理 | <code>DeviceProfileApi</code> | <code>ProfileService</code>、<code>ProfileAdvisor</code> |
| 策略下发 | <code>ProfileService.notifyToSync</code> | <code>WebSocketSessionManager</code> |
| 设备分组 | <code>DeviceApi</code> | <code>DeviceService.findGroupFamily/findChildGroups</code> |
| License | <code>LicenseApi</code>、<code>HostLicenseApi</code> | <code>LicenseService</code>、<code>HostLicenseService</code> |
| APK/OTA | <code>StoreAppsApi</code>、<code>OtasApi</code> | <code>StoreAppService</code>、<code>FileService</code>、<code>OtaFile</code> |
| 文件下载 | <code>FilesController</code>、<code>DeviceFilesApi</code> | <code>FileService</code>、<code>CloudStorageService</code> |
| 报表 | <code>ReportApi</code> | <code>ReportService</code>、<code>ExcelWriter</code> |
| 电池 | <code>BatteryApi</code> | <code>BatteryService</code> |
| 审计日志 | <code>LogsApi</code> | <code>LogService</code> |
| WebSocket | <code>/query</code> | <code>QueryHandler</code>、<code>WebSocketSessionManager</code>、<code>ReconnectMonitor</code> |
| 零接触 | <code>DpcController</code> | <code>DpcModel</code>、<code>StoreAppService</code> |
| 云存储 | <code>CloudStorageService</code> | <code>AwsS3</code>、<code>AzureBlob</code>、<code>GoogleCloudStorage</code> |
---
## 15. 读代码时最值得问的三个问题
1. **数据从哪里来?** 看 <code>@Document</code> 字段、<code>BaseService</code> 的查询条件、Mongo 索引。
2. **状态在哪里改?** 看 Service 的 save/update 与 <code>@Async</code>/定时任务。
3. **失败会怎样?** 看 <code>MidmResponse</code> 错误码、<code>throw</code>、catch 与 WebSocket <code>sendFeedback</code>。
把这三问套到每个方法上,Javadoc 里的“实现要点/主要调用”就是索引。