欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

为什么新出的《阿里Java开发手册》都要读一读?

程序员文章站 2024-03-24 14:21:40
...

每次阿里新出Java开发手册,都会抽时间读一读。不仅如此,还会将最新的Idea插件更新一番,以规范开发。这个习惯养成很久了,以至于将Idea更新到最新版本时,发现阿里对应的插件还不能用,竟然有些懊恼升级了。

以铜为镜,可以正衣冠

在4月22日,阿里Java开发手册“泰山版”发行了。借此来专门聊聊这套开发手册。

唐太宗曾说:“以铜为镜,可以正衣冠”。阿里的这套开发手册可谓开发人员的镜子,而且是非常明亮的镜子。

在开发过程中,最容易犯错的地方其实是写的最顺手的代码,顺手到不用过脑子就写得出来。多年之后,自己也坚信这是最好优雅的代码。此时,一个高手看到你的代码,说代码有XX问题。此时才发现,几年了竟然没有人提醒……

而阅读这套开发手册及对应的IDE插件,就好像有那么一个高手时刻站在身旁,帮你审阅代码。特别是当你对提示有疑惑的时候,尝试去深入了解为什么的时候,也正是提升能力的时候。

再次阅读的收获

泰山版花了差不多三个小时,从头到尾阅读了一遍,收获颇丰。而且该版本对比华山版新增了34条新规约、修改了90处描述。下面以几个例子来说说学到内容或一些感悟。

第一条:【强制】类型与中括号紧挨相连来表示数组。比如定义整形数组int[] arrayDemo;。

为什么将这个作为第一条?因为最近写的《Java数组,这一篇文章就真够了!》中也提出相同的建议。没想到在阿里的手册中再次重逢,这种似曾相识的感觉很好,更容易加深记忆。

第二条:【强制】包名统一使用单数形式,但是类名如果有复数含义,类名可以使用复数形式。正例:应用工具类包名为com.alibaba.ei.kunlun.aap.util、类名为MessageUtils(此规则参考 spring的框架结构)。

当读到这一条时,才发现之前在命名包的时候,特别是工具包的时候,一直在使用utils。虽然没什么影响,但这里提供了意外一个思路:可以写成util,而且在阿里要强制这么写。

第三条:【强制】Object的equals方法容易抛空指针异常,应使用常量或确定有值的对象来调用equals。

其实这一条一直在践行,值得留意的是最后的推荐说明中提到JDK7引入的java.util.Objects#equals方法。看了一下源代码,发现使用该方法类判断更加严谨清晰明了,难怪阿里推荐。以后可以尝试使用了。

public static boolean equals(Object a, Object b) {
    return (a == b) || (a != null && a.equals(b));
}

第四条:所有整型包装类对象之间值的比较,全部使用equals方法比较。

这一条不过多解释(-128至127会复用已有对象值),而且相关的底层实现原理,在面试的过程中被问到的概率非常大。

第五条:【强制】任何货币金额,均以最小货币单位且整型类型来进行存储。

其实这一条是非常棒的约定,特别是针对金融行业,如果采用浮点类型(比如double)来存储,必定是一个很大的坑。

第六条:【强制】浮点数之间的等值判断,基本数据类型不能用==来比较,包装数据类型不能用equals来判断。

针对浮点类型的包装类不能用equals来判断,还真是第一次了解到。这么多年基本上都在金融行业,很少直接使用浮点类型,基本上都是直接采用BigDecimal来代替。

文档中也建议使用BigDecimal来代替。同时还提出了另外一个指定可接受范围的方式,又打开了一个新思路。“指定一个误差范围,两个浮点数的差值在此范围之内,则认为是相等的。”

float a = 1.0f - 0.9f;
float b = 0.9f - 0.8f;
float diff = 1e-6f;

if (Math.abs(a - b) < diff) {   
    System.out.println("true");
}

第七条:【强制】禁止使用构造方法BigDecimal(double)的方式把double值转化为BigDecimal对象。BigDecimal(double)存在精度损失风险,在精确计算或值比较的场景中可能会导致业务逻辑异常。如:BigDecimal g = new BigDecimal(0.1f);实际的存储值为:0.10000000149。

这一项真的是第一次了解到,不文档不知道的。看来以后都直接使用字符串作为入参或使用valueOf方法来进行转换了。

第八条:【强制】判断所有集合内部的元素是否为空,使用isEmpty()方法,而不是size()==0的方式。说明:前者的时间复杂度为O(1),而且可读性更好。

其实一直都在使用isEmpty()方法,但某一刻也在怀疑这样写的必要性,读到这里,给自己一个坚持写下去的理由。

第九条:【推荐】集合初始化时,指定集合初始值大小。说明:HashMap使用 HashMap(int initialCapacity)初始化,如果暂时无法确定集合大小,那么指定默认值(16)即可。

在一条也一直在践行,但每次遇到不能够确定大小的时候,就非常纠结,如果不写值,检查工具会提示。现在好了,内部实现默认是16,这里直接也写16,再也不用看到IDE的提示而纠结了。

第十条:【强制】并发修改同一记录时,避免更新丢失,需要加锁。要么在应用层加锁,要么在缓存加锁,要么在数据库层使用乐观锁,使用version作为更新依据。说明:如果每次访问冲突概率小于20%,推荐使用乐观锁,否则使用悲观锁。乐观锁的重试次数不得小于3次。

一直偏爱使用乐观锁,这里给出了明确的阈值和依据,以后更加有底气了。

第十一条:【推荐】资金相关的金融敏感信息,使用悲观锁策略。说明:乐观锁在获得锁的同时已经完成了更新操作,校验逻辑容易出现漏洞,另外,乐观锁对冲突的解决策略有较复杂的要求,处理不当容易造成系统压力或数据异常,所以资金相关的金融敏感信息不建议使用乐观锁更新。正例:悲观锁遵循一锁二判三更新四释放的原则。

一直从事金融行业,对资金的变动是十分敏感的,锁是必不可少的,没想到的是阿里直接建议使用悲观锁策略,来点用悲观锁的底气。

第十二条:【强制】在高并发场景中,避免使用”等于”判断作为中断或退出的条件。说明:如果并发控制没有处理好,容易产生等值判断被“击穿”的情况,使用大于或小于的区间判断条件来代替。

说实话,如果没看到这一条,还真没留意。

小结

关于阿里Java开发手册还有很多很多从实践中总结出来的规范,真的值得经常读一读。对写出高质量、优雅、高效代码必不可少。每次读都如照镜子,总能发现一些不足,也能发现一些美。

最后送福利,最新版《阿里Java开发手册-泰山版》已经为大家准备好了。关注公众号“程序新视界”,回复“008”,免费获得PDF版本。

原文链接:《为什么新出的《阿里Java开发手册》都要读一读?

精品SpringBoot 2.x****

《Spring Boot 2.x ****全家桶》,精品Spring Boot 2.x****,打造一套最全的Spring Boot 2.x****。


程序新视界

公众号“程序新视界”,一个让你软实力、硬技术同步提升的平台

为什么新出的《阿里Java开发手册》都要读一读?