#### 开发环境 - Java17 - maven3.6+ #### 公共约定 1. 所有方法返回值必须使用包装类Result,并指明其泛型T 2. 所有service不允许调用service,目业务逻辑只允许在service中出现 3. 需要依赖注入的类,强烈建议使用构造注入 4. 业务代码关键模糊/多意的地方必须带有注释 5. 非业务接口必须要以IX开头 6. 抽像类必须要以AX开头 7. 尽量不要使用Object作为泛型 8. 如多个参数或者响应体,能明确个数时。强烈建议使用定长数组 9. 去除没有用到的类引用 10. 不要客惜废弃的老代码 11. 请不要写几余无用的代码。if(true)之类的代码块完全不应该出现,用空行隔开该段代码是更好的选择 12. ,请合理运用空行。空行可以用来隔开相对独立的代码块,有利于阅读和理解。但是不要使用超过一行的空行,对空间,别太警侈了 13. 请不要在两个地方出现完全相同的代码 14. 命名类,方法,变量值用简写,除非大家都人认 15. 把所有的类变量放到最前面,如果比较多请按用途分组排列 16. 拆分大的类,大的方法 千万不要堆出千行代码类!!!! #### 类注释模板 ```java /** *

类注释

* @author 作者 * 时间:xxxx年xx月xx日 */ ``` #### 方法注释模板 ```java /** *

描述

* @author 作者 * @param 参数描述,参数为类则包含{@link Object} * @param... * @return 返回值描述,如无返回值则为void 返回值为类则包含{@link object} * */ ``` #### 项目协同开发公共约定参照 project ```java