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

+456
View File
@@ -0,0 +1,456 @@
# 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 里的“实现要点/主要调用”就是索引。