阿里巴巴Java开发手册(黄山版)正式亮相,新增11条规约

阿里巴巴Java开发手册(黄山版)正式亮相,新增11条规约

众所周时,阿里巴巴的Java开发手册一直被封为Java开发界的典范和规约,是阿里巴巴和社会上从业人员智慧的结晶!随着对于开发要求的不断严格,Java开发手册也进行了不断的升级,前几日最新发布的黄山版就是最新发布的内容!

增加了11条最新规定!

大概目录

部分内容节选

(二) 常量定义

1.【强制】不允许任何魔法值(即未经预先定义的常量)直接出现在代码中。

反例:

// 开发者 A 定义了缓存的 key。

String key = "Id#taobao_" + tradeId;

cache.put(key, value);

// 开发者 B 使用缓存时直接复制少了下划线,即 key 是"Id#taobao" + tradeId,导致出现故障。

String key = "Id#taobao" + tradeId;

cache.get(key);

2.【强制】long 或 Long 赋值时,数值后使用大写 L,不能是小写 l,小写容易跟数字混淆,造成误解。

说明:public static final Long NUM = 2l; 写的是数字的 21,还是 Long 型的 2?

3.【强制】浮点数类型的数值后缀统一为大写的 D 或 F。

正例:public static final double HEIGHT = 175.5D;

public static final float WEIGHT = 150.3F;

4.【推荐】不要使用一个常量类维护所有常量,要按常量功能进行归类,分开维护。

说明:大而全的常量类,杂乱无章,使用查找功能才能定位到要修改的常量,不利于理解,也不利于维护。

正例:缓存相关常量放在 CacheConsts 下;系统配置相关常量放在 SystemConfigConsts 下。

5.【推荐】常量的复用层次有五层:跨应用共享常量、应用内共享常量、子工程内共享常量、包内共享常量、类内共享常量。

1)跨应用共享常量:放置在二方库中,通常是 client.jar 中的 constant 目录下。

2)应用内共享常量:放置在一方库中,通常是子模块中的 constant 目录下。

反例:常量也要统一定义成应用内共享常量,两个程序员在两个类中分别定义了表示“是”的常量:

类 A 中:public static final String YES = "yes";

类 B 中:public static final String YES = "y";

A.YES.equals(B.YES),预期是 true,但实际返回为 false,导致线上问题。

3)子工程内部共享常量:即在当前子工程内的 constant 目录下。

4)包内共享常量:即在当前包下单独的 constant 目录下。

5)类内共享常量:直接在类内部 private static final 定义。

6.【推荐】如果变量值仅在一个固定范围内变化用 enum 类型来定义。

说明:如果存在名称之外的延伸属性应使用 enum 类型,下面正例中的数字就是延伸信息,表示一年中的第几个季节。

正例:

public enum SeasonEnum {

SPRING(1), SUMMER(2), AUTUMN(3), WINTER(4);

private int seq;

SeasonEnum(int seq) {

this.seq = seq;

}

public int getSeq() {

return seq;

}

}

(二) 索引规约

1.【强制】业务上具有唯一特性的字段,即使是组合字段,也必须建成唯一索引。

说明:不要以为唯一索引影响了 insert 速度,这个速度损耗可以忽略,但提高查找速度是明显的;另外,即使在应用层做了非常完善的校验控制,只要没有唯一索引,根据墨菲定律,必然有脏数据产生。

2.【强制】超过三个禁止 join。需要 join 的字段,数据类型保持绝对一致;多表关联查询时,保证被关联的字段需要有索引。

说明:即使双表 join 也要注意表索引、SQL 性能。

3.【强制】在 varchar 字段上建立索引时,必须指定索引长度,没必要对全字段建立索引,根据实际文本区分度决定索引长度。

说明:索引的长度与区分度是一对矛盾体,一般对字符串类型的数据,长度为 20 的索引,区分度会高达 90%以上,可以使用 count(distinct left(别名,索引长度)) / count(*) 的区分度来确定。

4.【强制】页面搜索严禁左模糊或者全模糊,如果需要请走搜索引擎来解决。

说明:索引文件具有 B-Tree 的最左前缀匹配特性,如果左边的值未确定,那么无法使用此索引。

5.【推荐】如果有需要 order by 的场景,请注意利用索引的有序性。order by 最后的字段是组合索引的一部分,并且放在索引组合顺序的最后,避免出现 filesort 的情况,影响查询性能。

正例:where a = ? and b = ? order by c;索引:a_b_c

反例:索引如果存在范围查询,那么索引有序性无法利用,如:WHERE a > 10 ORDER BY b;索引 a_b 无法排序。

6.【推荐】利用覆盖索引来进行查询操作,避免回表。

说明:如果一本书需要知道第 11 章是什么标题,会翻开第 11 章对应的那一页吗?目录浏览一下就好,这个目录就是起到覆盖索引的作用。

正例:能够建立索引的种类分为主键索引、唯一索引、普通索引三种,而覆盖索引只是一种查询的一种效果,用 explain

的结果,extra 列会出现:using index。

7.【推荐】利用延迟关联或者子查询优化超多分页场景。

说明:MySQL 并不是跳过 offset 行,而是取 offset+N 行,然后返回放弃前 offset 行,返回 N 行,那当 offset 特别大的时候,效率就非常的低下,要么控制返回的总页数,要么对超过特定阈值的页数进行 SQL 改写。

正例:先快速定位需要获取的 id 段,然后再关联:

SELECT t1.* FROM 表 1 as t1 , (select id from 表 1 where 条件 LIMIT 100000 , 20) as t2 where t1.id = t2.id

8.【推荐】SQL 性能优化的目标:至少要达到 range 级别,要求是 ref 级别,如果可以是 const 最好。

说明:

1)consts 单表中最多只有一个匹配行(主键或者唯一索引),在优化阶段即可读取到数据。

2)ref 指的是使用普通的索引(normal index)。

3)range 对索引进行范围检索。

反例:explain 表的结果,type = index,索引物理文件全扫描,速度非常慢,这个 index 级别比较 range 还低,与全表扫描是小巫见大巫。

9.【推荐】建组合索引的时候,区分度最高的在最左边。

正例:如果 where a = ? and b = ?,a 列的几乎接近于唯一值,那么只需要单建 idx_a 索引即可。

说明:存在非等号和等号混合判断条件时,在建索引时,请把等号条件的列前置。如:where c > ? and d = ? 那么即使

c 的区分度更高,也必须把 d 放在索引的最前列,即建立组合索引 idx_d_c。

10.【推荐】防止因字段类型不同造成的隐式转换,导致索引失效。

11.【参考】创建索引时避免有如下极端误解:

1)索引宁滥勿缺。认为一个查询就需要建一个索引。

2)吝啬索引的创建。认为索引会消耗空间、严重拖慢记录的更新以及行的新增速度。

3)抵制唯一索引。认为唯一索引一律需要在应用层通过“先查后插”方式解决

最后的最后需要领取这份黄山版学习资源的同学麻烦帮忙点赞+转发一下文章,然后私信我【学习】领取哈!

</article>
  • 1
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
### 回答1: 阿里巴巴Java开发手册是一份非常受欢迎的编码规范和最佳实践指南。这个手册旨在帮助Java开发人员写出高质量、高效率、易于维护的代码。 泰山阿里巴巴Java开发手册的一种特定本。与其他本相比,泰山是在原有基础上针对一些具体场景进行了优化和增补。它提供了更加详细和全面的规则,以帮助开发人员更好地理解和遵守代码规范。 阿里巴巴Java开发手册泰山主要包括如下几个方面的内容: 1. 命名规范:定义了变量、方法、类等命名的规则,以提高代码的可读性和一致性。 2. 代码格式化:规定了代码缩进、空格、括号等格式化的规则,以确保代码的可读性和统一性。 3. 注释指南:指导开发人员如何编写清晰、简洁、有意义的注释,以便于他人理解和维护代码。 4. 异常处理:规范了异常的使用和处理方式,以避免不必要的异常处理和错误。 5. 并发编程:提供了针对并发编程的规范和最佳实践,以确保多线程代码的安全性和性能。 通过遵循阿里巴巴Java开发手册泰山,可以帮助开发人员写出高质量的Java代码,在团队合作中提高代码的可读性和一致性,减少bug的产生,并增加代码的可维护性。在阿里巴巴等大型企业和项目中广泛采用,是Java开发人员必备的参考手册。 ### 回答2: 阿里巴巴Java开发手册PDF泰山阿里巴巴集团推出的一份Java开发规范文档。该手册汇集了阿里巴巴集团多年来在Java开发方面的经验总结,帮助开发人员遵循最佳实践,提高代码质量和开发效率。 该手册的“泰山”是该手册的最新本,泰山在中国文化中象征着高大、坚固和崇高,表示该本经过了更精细的修订和完善,具备更高的质量和稳定性。 阿里巴巴Java开发手册PDF泰山的内容主要包括以下几个方面: 1. 编程规约:包括命名规范、代码风格、注释规范等方面的规定,旨在保证代码的可读性和易于维护。 2. 异常日志:该部分主要介绍了如何正确地使用日志记录库,以及如何处理异常和错误信息,以便快速定位和解决问题,提高系统稳定性。 3. 并发编程:介绍了如何正确使用Java的并发相关类,包括多线程编程、线程池、锁机制等,以保证并发程序的正确性和高性能。 4. 配置管理:指导开发人员如何管理系统的配置信息,包括如何处理配置文件、环境变量、加密配置等问题,以保证系统的可配置性和安全性。 5. 安全规范:强调了安全编码的重要性,包括如何防范常见的安全漏洞,如SQL注入、XSS攻击等,以保护系统的数据安全性。 阿里巴巴Java开发手册PDF泰山的推出,对于提高Java开发人员的编码水平和团队的开发效率具有重要意义,也是阿里巴巴集团在推动Java社区发展方面的贡献。 ### 回答3: 阿里巴巴Java开发手册是由阿里巴巴集团编写的一份规范化的Java开发指南,目的是为了提高团队开发效率、减少 Bug、统一代码风格、规避潜在的安全风险等。泰山是指该手册的最新本,可能是在泰山山脉的名称上命名的,以突显其稳定且强大的特性。 该手册详细介绍了Java开发中的各种规范和最佳实践,包括命名规范、代码风格、异常处理、代码注释、日志记录、单元测试等方面,旨在让开发人员写出高质量、可维护的代码。 该手册主要有以下特点: 1. 规范统一:阿里巴巴作为行业领导者,制定了一套统一的规范,可帮助开发人员避免因个人习惯带来的代码风格冲突。 2. 实践总结:该手册是由阿里巴巴实际项目开发经验总结而来,包含了许多在实践中积累的经验和教训,对团队的开发效率和代码质量提高非常有帮助。 3. 安全性保障:手册中考虑了许多潜在的安全风险,提供了安全编码的建议和指导,有助于开发人员编写更加安全可靠的代码。 4. 更新迭代:作为一个活跃的开发指南,该手册定期更新,以适应技术的发展和变化,保持在行业标准的前沿。 阅读并遵守阿里巴巴Java开发手册可以帮助开发人员提高编码水平,增加团队协作效率,减少潜在的安全风险,对于Java开发者来说是一份非常有价值的参考资料。希望开发人员能够认真学习,并将其中的规范和最佳实践应用到实际工作中。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值