mirror of
https://github.com/hpd840321/starRiverProperty.git
synced 2026-06-09 08:20:31 +08:00
bf20a13c96
Made-with: Cursor
1.2 KiB
1.2 KiB
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。 |
建议优先级
- 为对外 DTO 统一
serialVersionUID策略(或评估 Protobuf/JSON 单一序列化路径)。 - 修正对外可见的拼写错误类名时评估协议兼容(
@JSONField别名等)。 - IDE 格式化 + 去除反编译行号噪声。