mirror of
https://github.com/hpd840321/starRiverProperty.git
synced 2026-06-09 08:20:31 +08:00
bf20a13c96
Made-with: Cursor
19 lines
1.2 KiB
Markdown
19 lines
1.2 KiB
Markdown
# 03 `maven-cloudwalk-device-sdk` — 阿里巴巴规范走查(整理版)
|
||
|
||
**范围**:`maven-cloudwalk-device-sdk/**/*.java`(排除 `target/`),约 **162** 个文件。
|
||
|
||
## 主要发现
|
||
|
||
| 类别 | 说明 |
|
||
|------|------|
|
||
| **序列化** | 大量 `implements Serializable` 的 DTO/Param **未声明 `serialVersionUID`**(约数十个文件);内部静态类序列化缺独立 UID。 |
|
||
| **命名** | `NotifyUploadPanoramamResult`(Panorama)、`FaceRegistionParam`(Registration)等拼写疑点;内部类名 `deviceData`、`helmetsData` 等小写开头不符合类型 UpperCamelCase。 |
|
||
| **格式** | 部分文件 `package` 与类型声明间**大段空行**;若仍残留 `/* N */` 行号注释,应继续跑 `scripts/strip_jdcore_java_noise.py`。 |
|
||
| **启发式** | 与 `00-heuristic-scan.md` 一致:`DeviceV2CommonBaseDTO` 等存在**行尾空白**;未见 `System.out`、空 catch。 |
|
||
|
||
## 建议优先级
|
||
|
||
1. 为对外 DTO 统一 **`serialVersionUID`** 策略(或评估 Protobuf/JSON 单一序列化路径)。
|
||
2. 修正对外可见的**拼写错误**类名时评估协议兼容(`@JSONField` 别名等)。
|
||
3. IDE **格式化** + 去除反编译行号噪声。
|