送你最新版Java开发手册

相信写Java的同学应该都听过阿里巴巴的《Java开发手册》吧?里面有很多关于代码格式,代码规约的正例、反例,简直就是居家旅行必备的手册。

这本开发手册不仅包含了代码级的规约,甚至还包括了设计、工程结构、数据库等等的规约,推荐每一位Java工程师都要通读一遍。

而最近这本手册又更新了黄山版,今天我们就来梳理一下各个版本的改动。

如果想要这本手册的各个版本汇总全集,可以关注下方公众号SpringForAll社区,回复关键词【开发手册】,就能免费获取!

正式版 2017.02.09

阿里巴巴集团正式对外发布

 

完美版 2017.05.20

1)根据云栖社区的“聚能聊”活动反馈,对手册的页码、排版、描述进行修正。

2)增加 final 的适用场景描述。

3)增加关于锁的粒度的说明。

4)增加“指定集合大小”的详细说明以及正反例。

5)增加卫语句的示例代码。

6)明确数据库表示删除概念的字段名为 is_deleted

纪念版 2017.11.30

修正部分描述;采用和 P3C 开源 IDE 检测插件相同的 Apache2.0 协议。

详尽版 2018.05.20

增加设计规约大类,共 16 条。

华山版 2019.06.19

1)鉴于本手册是社区开发者集体智慧的结晶,本版本移除阿里巴巴 Java 开发手册的限定词“阿里巴巴”。

2)新增 21 条新规约。比如,switch 的 NPE 问题、浮点数的比较、无泛型限制、锁的使用方式、判断表达式、日期格式等。

3)修改描述 112 处。比如,IFNULL 的判断、集合的 toArray、日志处理等。

4)完善若干处示例。比如,命名示例、卫语句示例、enum 示例、finally 的 return示例等。

泰山版 2020.04.22

1)发布错误码统一解决方案,详细参考附表 3**。** 

2)新增 34 条新规约。比如,日期时间的闰年、闰月问题,三目运算的自动拆箱,SQL查询的表别名限定,Collectors 类的 toMap()方法使用注意等。 

3)修改描述 90 处。比如,阻塞等待锁、建表的小数类型等。 

4)完善若干处示例。比如,ISNULL 的示例等。

嵩山版 2020.08.03

1)新增前后端规约 14 条。 

2)新增禁止任何歧视性用语的约定。 

3)新增涉及敏感操作的情况下日志需要保存六个月的约定。 

4)修正 BigDecimal 类中关于 compareTo 和 equals 的等值比较。

5)修正 HashMap 关于 1024 个元素扩容的次数。

6)修正架构分层规范与相关说明。

7)修正泰山版中部分格式错误和描述错误。

黄山版 2022.02.03

1)新增11条新规约。比如,浮点数的后缀统一为大写;枚举的属性字段必须是私有且不可变;配置文件中的密码需要加密等。

2)新增描述中的正反例2条。比如,多个构造方法次序、NoSuchMethodError处理;新增拓展说明5条。比如,父集合元素的增加或删除异常等。

3)修改描述22处。比如,父集合元素的增加或删除异常等。

4)修正嵩山版中部分代码格式错误和描述错误。

 

关注下方公众号SpringForAll社区

回复关键词【开发手册】,

就能免费获取开发手册合集!

(已包含最新黄山版)

请登录后发表评论

    没有回复内容