阿里巴巴泰山版《Java 开发者手册》，也是一份防坑指南

程序员文章站 2024-03-24 15:39:52

...

我是风筝，公众号「古时的风筝」，一个不只有技术的技术公众号，一个在程序圈混迹多年，主业 Java，另外 Python、React 也玩儿的 6 的斜杠开发者。
Spring Cloud 系列文章已经完成，可以到我的github 上查看系列完整内容。也可以在公众号内回复「pdf」获取我精心制作的 pdf 版完整教程。

4月22日，阿里巴巴发布了泰山版《Java 开发手册》，以前以为终极版就真的是终极版了，没想到还是想的太简单了，继终极版之后又发布了详尽版、华山版，这不，泰山版又来了。想想也对，行业一直在发展，JDK 也一直在更新，怎么可能有终极版。

自从2017年阿里发布终结版发布以来，我就把这个手册当做开发规范使用，放在电脑中最显眼的地方，时不时就翻出来看一看，并且在团队中推广，还顺便安利给了一些朋友。每次有新版本发布都第一时间拿下来再重新读一遍。

本次泰山版发布，对比上一版本有如下几个更新：

发布错误码统一解决方案。
新增 34条新规约，比如，日期时间的闰年、闰月问题，三目运算的自动拆箱，SQL 查询的表别名限定，Collectors 类的 toMap()方法使用注意等。
修改描述 90处，比如，阻塞等待锁、建表的小数类型等。
完善若干处示例，比如，ISNULL 的示例等。

为什么要经常拿出来读一读呢？

阿里巴巴泰山版《Java 开发者手册》，也是一份防坑指南

手册涉及从项目设计到编码、部署的各个方面。但是对于开发者个人来说，有些方面其实不常接触，比如并发控制有很多人接触的机会有限。再比如异常定义、MySQL 管理，可能是项目开始的时候被核心开发人员或者架构师统一定制好了，有些同学也就直接拿来主义了，也不关心具体的设计原理和实现细节。

手册也不长，这一版正文只有 57 页，读一遍也花不了多长时间。其中有些方面是我们平时也经常说到的，比如命令风格、常量定义等，也有一些方面可能平时就没那么注意了，比如注释规约，注释怎么写，写在哪里，什么格式。不夸张的说，很多时候，能写注释的都已经很不错了，更不要说把注释写清楚，甚至有很多人根本就不怎么写注释，觉得这是浪费时间。

这个手册是阿里巴巴多年开发经验的结晶，除了上面说到的命名、注释等提升代码可读性、易读性的规约，还包括了正确的建表、良好的工程结构、良好的异常处理、安全控制，还有一些平时常用 JDK 功能的防坑指南。

命名风格、常量定义、代码格式

这几个基本上写过几年代码的都会有一套差不多的规范，基本上和阿里巴巴开发者手册相差无几。

OOP 规约

6.【强制】Object的equals方法容易抛空指针异常，应使用常量或确定有值的对象来调用equals。

正例:“test”.equals(object);
反例:object.equals(“test”);
说明:推荐使用 java.util.Objects#equals(JDK7 引入的工具类)。

反例中的 object 是一个变量，并且这个变量为 null，就会抛出异常。推荐使用 Objects.equals(s1, s2)。

8. 【强制】任何货币金额，均以最小货币单位且整型类型来进行存储。

比如说人民币的最小单位是分，那假设一个商品的价格是1元钱，那就存到数据库的 price 字段，字段类型是 int 或者 bigint，值为 100，单位是分，也就是100分。

我就在这个问题上入过坑，几年前一个系统中的价格字段用的是浮点数，单位还是元，后面在价格计算上很是麻烦，而且浮点数的计算并不是完全准确的，尤其是涉及到小数位的时候。最后还是把字段调成了 int 类型，代码上涉及到价格的地方都重构了。

所以，后来当我看到手册中的这条规约的时候，有种相见恨晚的感觉。我用了惨痛的经验才换来这个教训，如果早点看到呢，岂不是省了很多事。

9. 【强制】浮点数之间的等值判断，基本数据类型不能用==来比较，包装数据类型不能用 equals 来判断。

反例：

float a = 1.0f - 0.9f; 
float b = 0.9f - 0.8f;
	if (a == b) {
	// 预期进入此代码快，执行其它业务逻辑 // 但事实上 a==b 的结果为 false
}
Float x = Float.valueOf(a);
Float y = Float.valueOf(b); 
if (x.equals(y)) {
  // 预期进入此代码快，执行其它业务逻辑
  // 但事实上 equals 的结果为 false
}