《阿里巴巴Java开发手册》(以下简称“《手册》”)是阿里巴巴集团技术团队的集体智慧结晶和经验总结,经历了多次大规模一线实战的检验及不断的完善,系统化地被整理成册,回馈给广大开发者。
现代软件行业的高速发展对开发者的综合素质要求越来越高,因为不仅是编程知识点,其他维度的知识点也会影响软件的最终交付质量。比如,数据库的表结构和索引设计缺陷可能带来软件的架构缺陷或性能风险;单元测试的失位导致集成测试困难;没有鉴权的漏洞代码易被黑客攻击等。(与版权页介绍一致)所以,《手册》以Java开发者为中心视角,划分为编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约七个维度,再根据内容特征,细分成若干个二级子目录。
根据约束力强弱及故障敏感性,规约依次分为【强制】、【推荐】、【参考】三大类。在规约条目的延伸信息中,“说明”对内容做了适当扩展和解释,“正例”是提倡的编码和实现方式,“反例”是需要提防的雷区及真实的错误案例。