阿里巴巴Java开发手册
在看此手册前,你需要懂得
《阿里巴巴 Java 开发手册》是阿里巴巴集团技术团队的集体智慧结晶和经验总 结,经历了多次大规模一线实战的检验及不断完善,系统化地整理成册,回馈给广大 开发者。现代软件行业的高速发展对开发者的综合素质要求越来越高,因为不仅是编 程知识点,其它维度的知识点也会影响到软件的最终交付质量。比如:
- 数据库的表结构和索引设计缺陷可能带来软件上的架构缺陷或性能风险;
- 工程结构混乱导致后续维护艰难;
- 没有鉴权的漏洞代码易被黑客攻击等等。
所以本手册以 Java 开发者为中心视角,划分为:
- 编程规约
- 异常日志
- 单元测试
- 安全规约
- MySQL 数据库
- 工程结构
- 设计规约
七个维度,再根据内容特征,细分成若干二级子目录。根据约束力强弱及故障 敏感性,规约依次分为强制、推荐、参考三大类。对于规约条目的延伸信息中:
- “说明”对规约做了适当扩展和解释;
- “正例” 提倡什么样的编码和实现方式;
- “反例” 说明需要提防的雷区,以及真实的错误案例。
本手册的旨在码出高效,码出质量。现代软件架构的复杂性需要协同开发完成, 如何高效地协同呢?无规矩不成方圆,无规范难以协同,比如,制订交通法规表面上 是要限制行车权,实际上是保障公众的人身安全,试想如果没有限速,没有红绿灯, 谁还敢上路行驶。对软件来说,适当的规范和标准绝不是消灭代码内容的创造性、优 雅性,而是限制过度个性化,以一种普遍认可的统一方式一起做事,提升协作效率, 降低沟通成本。代码的字里行间流淌的是软件系统的血液,质量的提升是尽可能少踩 坑,杜绝踩重复的坑,切实提升系统稳定性,码出质量。 考虑到可以零距离地与众多开发同学进行互动,决定未来在线维护《手册》内容, 此 1.4.0 的 PDF 版本,是最为详尽的版本,新增设计规约大章节,并增加若干条目;我 们已经在 2017 杭州云栖大会上发布了阿里巴巴 Java 开发规约插件(点此下载),阿里 云效(一站式企业协同研发云)也集成了代码规约扫描引擎。