优化java代码风格-换行策略

2026-08-03 15:40:32 +08:00
parent c7bd957e6f
commit 55a669b0ab
6 changed files with 43 additions and 1 deletions
@@ -34,6 +34,7 @@
 ## API 与兼容性

 - **必须**：公共 API 明确输入校验、返回语义、错误模型、幂等性和副作用。
+- **必须**：单资源路径已经通过 `@PathVariable` 确定资源身份时，不得再使用可选查询参数表达另一套资源标识。不同标识的查询入口应拆分；若多个标识共同构成业务校验条件，应明确必填性、匹配规则和错误语义。
 - **必须**：新增重载时检查 `null`、lambda、自动装箱和可变参数是否造成调用歧义。
 - **必须**：修改 DTO、枚举、JSON 字段、RPC 签名或异常类型前评估调用方兼容性。
 - **推荐**：返回接口类型而非具体集合实现；不要泄漏 ORM 实体、框架上下文或内部异常。