在阿里规约的基础上,针对项目做了扩展,并且将一些不适用的去掉以供内部分享。
《阿里巴巴Java开发手册》是阿里巴巴集团技术团队的集体经验总结,经历了 多次大规模一线实战的检验及不断的完善,反馈给广大开发者。现代软件行业的高速 发展对开发者的综合素质要求越来越高,因为不仅是编程知识点,其它维度的知识点 也会影响到软件的最终交付质量。比如:数据库的表结构和索引设计缺陷可能带来软 件上的架构缺陷或性能风险;工程结构混乱导致后续维护艰难;没有鉴权的漏洞代码 被黑客攻击等等。所以本手册以Java开发者为中心视角,划分为编程规约、异常日志 规约、MySQL规约、工程规约、安全规约五大块,再根据内容特征,细分成若干二级子 目录。根据约束力强弱及故障敏感性,规约依次分为强制、推荐、参考三大类。对于 规约条目的延伸信息中,“说明”对内容做了引申和解释;“正例”提倡什么样的编 码和实现方式;“反例”说明需要提防的雷区,以及真实的错误案例。
本手册的愿景是码出质量、码出高效。代码的字里行间流淌的是软件生命中的血液,质量的提升是尽可能少踩坑,杜绝踩重复的坑,切实提升质量意识。另外,现代软件架构都需要协同开发完成,高效协作即降低协同成本,提升沟通效率,所谓无规矩不成方圆,无规范不能协作。众所周知,制订交通法规表面上是要限制行车权,实际上是保障公众的人身安全。试想如果没有限速,没有红绿灯,谁还敢上路行驶。对软件来说,适当的规范和标准绝不是消灭代码内容的创造性、优雅性,而是限制过度个性化,以一种普遍认可的统一方式一起做事,提升协作效率。
《阿里巴巴Java开发手册》,开放包容地认真听取社区、博客、论坛的反馈,及 时修正,保持与时俱进。请关注手册末页的“阿里技术”和“云栖社区”公众号获取 最新版。
Java开发手册
版本号 | 更新日期 | 备注 |
---|---|---|
1.1.0 | 2017.2.27 | 增加前言和专有名词说明,修正部分描述。 |
1.1.1 | 2017.3.31 | 修正页码总数和部分示例。 |
1.2.0 | 2017.05.25 | 同步 1.2.0 更新 |