阿里的《Java开发手册》距离上次发布已经过去了 10 个月了，而这次发布也增加了很多干货内容，比如：新增 34 条规约，修改描述 90 处，其中错误码规则更是第一次提出完整的解决方案，发布日志如下图所示：

回顾阿里巴巴开发手册1.4.0版

一、编程规约

二、异常日志

三、单元测试

四、安全规约

五、MySQL数据库

六、工程结构

七、设计规约

终极版

一、编程规约

二、异常日志

三、单元测试

四、安全规约

五、MySQL数据库

六、工程结构

新增内容概览

本次更新主要更新的内容有：

新增了错误码规范；
扩充了日期（闰年、闰月等）处理方案；
表别名规范；
三目运算符规范等。

接下来我们来看这些新增内容的具体含义。

1.错误码规范

之前版本中是没有关于「错误码」的整体说明的，而这个版本增加了很大的篇幅，来把这个前后端配合的重要环节「错误码」部分，做了详细的规范和说明，可谓非常的香，具体规范如下：

【强制】错误码的制定原则：快速溯源、简单易记、沟通标准化。
【强制】错误码不体现版本号和错误等级信息。
【强制】全部正常，但不得不填充错误码时返回五个零：00000。
【强制】错误码为字符串类型，共 5 位，分成两个部分：错误产生来源 + 四位数字编号。

说明：错误产生来源分为 A/B/C：

A：表示错误来源于用户，比如参数错误，用户安装版本过低，用户支付超时等问题；
B：表示错误来源于当前系统，往往是业务逻辑出错，或程序健壮性差等问题；
C：表示错误来源于第三方服务，比如 CDN 服务出错，消息投递超时等问题；四位数字编号从 0001 到 9999，大类之间的步长间距预留 100，详情可见《Java开发手册》正文。

2.扩充了日期处理方案

一个写死为 365 天的年份天数，在闰年里让大家尝尽了悲伤痛楚，比如，缓存有效期 = 3652460*60 秒，结果提前一天所有缓存同时失效，高并发访问时数据库就跪了。

【强制】不要在程序中写死一年为 365 天，避免在公历闰年时出现日期转换错误或程序逻辑错误。

正例：

反例：

3.表别名规范

【强制】对于数据库中表记录的查询和变更，只要涉及多个表，都需表名）进行限定。说明：对多表进行查询记录、更新记录、删除记录时，如果对操作列没有限定表的别名（或表名），并且操作列在多个表中存在时，就会抛异常。正例：select t1.name from table_first as t1 , table_second as t2 where t1.id=t2.id;

反例：在某业务中，由于多表关联查询语句没有加表的别名（或表名）的限制，正常运行两年后，最近在某个表中增加一个同名字段，在预发布环境做数据库变更后，线上查询语句出现出 1052 异常：Column ‘name’ in field list is ambiguous。

【推荐】SQL 语句中表的别名前加 as，并且以 t1、t2、t3、…的顺序依次命名。说明：

别名可以是表的简称，或者是根据表出现的顺序，以 t1、t2、t3 的方式命名。
别名前加 as 使别名更容易识别。正例：select t1.name from table_first as t1, table_second as t2 where t1.id=t2.id;

4.三目运算符规范

原来在三目运算符中：

condition ? 表达式1 : 表达式2

表达式 1 和 2 在涉及算术计算或数据类型转换时，会触发自动拆箱。拆箱操作本来没有问题，但是当其中的操作数为 null 值时，一个大大的 NPE 就砸到了我滴脸上，如下代码所示：

注意：a*b 的结果是 int 类型，那么 c 会强制拆箱成 int 类型，抛出 NPE 异常。

【强制】三目运算符 condition? 表达式 1 : 表达式 2 中，高度注意表达式 1 和 2 在类型对齐时，可能抛出因自动拆箱导致的 NPE 异常。

说明：以下两种场景会触发类型对齐的拆箱操作：

表达式 1 或表达式 2 的值只要有一个是原始类型。
表达式 1 或表达式 2 的值的类型不一致，会强制拆箱升级成表示范围更大的那个类型。

阿里巴巴内部开发手册—1.4.0版+终极版

内部开发手册

阿里巴巴内部PPT、PDF及JD亿级流量架构

阿里内部PPT、PDF及开发手册1.4.0版+终极版+泰山版感兴趣的可以敲敲小编的脑瓜子哦

阿里巴巴开发手册“泰山”版它来了，1.4.0+终极版+阿里内部PPT相关推荐

（阿里巴巴开发手册）为什么阿里巴巴推荐内部员工使用StringBuilder？
今日我在阅读阿里巴巴开发手册泰山版,发现开发手册上有这么一条:[推荐] 循环体内,字符串的连接方式,使用 StringBuilder 的 append 方法进行扩展. 字符串的三种表示类型 Strin ...
全套阿里巴巴开发手册和大神解读一起给你【2022年整理】
前些日子查些资料想要看一下阿里巴巴开发手册,网上一搜出来了一大推,也搞不清楚哪个,更让人讨厌的是有很多介绍开发手册文章的是某些培训机构来吸引流量的,都能看得来的写文章的人根本不懂这些东西,最后放个二维 ...
它来了：阿里巴巴Java开发手册泰山版解读
点击上方蓝色"程序猿DD",选择"设为星标" 回复"资源"获取独家整理的学习资料! 来源 | 公众号「阿飞的博客」 <Java开发手册 ...
阿里巴巴java开发手册-泰山版下载
最近,阿里的<Java开发手册>又更新了,这个版本历经一年的修炼,取名:<Java开发手册(泰山版)>正式出道.正所谓无规矩不成方圆,在程序员的世界里,也存在很多规范,阿里出版 ...
解读《Java开发手册(泰山版)》- 会当凌绝顶，一览众山小 (附下载地址)
阿里的<Java开发手册>被Java开发者所拜读,基本人手一册,就在前几天(2020.04.22)发布了泰山版 - 会当凌绝顶,一览众山小,而这次发布新增了很多干货内容,在此,给大家分享一 ...
C++手册_阿里新版《Java 开发手册(泰山版)》内容解读（附下载地址）
阿里的<Java开发手册>距离上次发布已经过去了 10 个月了,而这次发布也增加了很多干货内容,比如:新增 34 条规约,修改描述 90 处,其中错误码规则更是第一次提出完整的解决方案,发 ...
阿里巴巴开发手册最新版、码出高效、性能调优实战、成神之路
清幽现云山, 虚静出内功 <阿里巴巴Java开发手册>是阿里内部Java工程师所遵循的开发规范,涵盖编程规约.单元测试规约.异常日志规约.MySQL规约.工程规约.安全规约等,这是近万名阿 ...
魔法值是什么？（为什么在阿里巴巴开发手册中提到不允许任何魔法值直接出现在代码中）
在阿里巴巴开发手册中,提到魔法值,是在最开始的常量定义中提到的.即如下图: 那么,魔法值究竟是什么? 在al手册中说是未经预先定义的常量. 其实这样说就已经很明了了,但毕竟是一个不常见的概念,所以我在 ...
包机制、阿里巴巴开发手册
公司域名倒置作为包名 com.baidu.www 阿里巴巴开发手册可百度搜索看看

阿里巴巴开发手册“泰山”版它来了，1.4.0+终极版+阿里内部PPT