阿里巴巴Java开发手册：提升协作效率与代码质量
需积分: 0 90 浏览量
更新于2024-07-15
2
收藏 1.59MB PDF 举报
《阿里巴巴-Java开发手册(嵩山版)》是一份由阿里巴巴集团技术团队编撰的权威指南，旨在提升Java开发者的技术素养和团队协作效率。该手册基于实战经验和集体智慧，系统地涵盖了Java编程规范的多个重要维度，包括：
1. **编程规约**：手册首先强调了命名风格，如采用驼峰命名法（CamelCase）等，以提高代码可读性和一致性。此外，还涉及变量、函数、类名的命名规则，确保符合团队约定和最佳实践。
2. **异常日志**：手册教导开发者如何有效记录和处理异常，提倡使用有意义的日志信息，以便快速定位和解决问题，提升系统稳定性。
3. **单元测试**：通过正例和反例的方式，指导编写高质量的单元测试，以验证代码的功能正确性和健壮性，降低维护成本。
4. **安全规约**：讲解了关于权限管理、数据加密和防止SQL注入等安全方面的注意事项，确保代码不易受到黑客攻击。
5. **MySQL数据库**：讨论了数据库设计原则，如合理创建表结构、优化索引、避免性能瓶颈，以及如何处理数据库相关错误和异常。
6. **工程结构**：强调代码组织的清晰度和可维护性，提倡模块化、分层设计，减少耦合度，便于团队协作。
7. **设计规约**：涵盖了面向对象设计、设计模式的运用，以及如何遵循 SOLID 原则，保证软件架构的健壮和灵活性。
8. **规约分类**：手册将规约按照约束力和故障敏感性分为【强制】、【推荐】、【参考】三级，帮助开发者理解其重要性和适用范围。
9. **工具支持**：提到发布的Java开发规约IDE插件和阿里云效的代码规约扫描引擎，这些工具可以辅助开发者在日常工作中遵循规范。
10. **教育理念**：《码出高效》和《Java开发手册》不仅是技术文档，还融入了计算机基础知识、面向对象编程、JVM原理、数据结构等内容，以提升开发者的技术深度，并通过实例和故障案例进行教学。
通过阅读和遵循这份手册，开发者可以提升编程技能，减少错误，增强团队协作，并以一种更高效、更一致的方式编写高质量的Java代码。手册的目标是帮助开发者实现"码出高效，码出质量"，并以技术情怀回馈社会。
Java 开发手册
8/59
8. 【强制】任何货币金额，均以最小货币单位且整型类型来进行存储。
9. 【强制】浮点数之间的等值判断，基本数据类型不能用==来比较，包装数据类型不能用 equals
来判断。
说明：浮点数采用“尾数+阶码”的编码方式，类似于科学计数法的“有效数字+指数”的表示方式。二进
制无法精确表示大部分的十进制小数，具体原理参考《码出高效》。
反例：
float a = 1.0F - 0.9F;
float b = 0.9F - 0.8F;
if (a == b) {
// 预期进入此代码块，执行其它业务逻辑
// 但事实上 a==b 的结果为 false
}
Float x = Float.valueOf(a);
Float y = Float.valueOf(b);
if (x.equals(y)) {
// 预期进入此代码块，执行其它业务逻辑
// 但事实上 equals 的结果为 false
}
正例：
(1) 指定一个误差范围，两个浮点数的差值在此范围之内，则认为是相等的。
float a = 1.0F - 0.9F;
float b = 0.9F - 0.8F;
float diff = 1e-6F;
if (Math.abs(a - b) < diff) {
System.out.println("true");
}
(2) 使用 BigDecimal 来定义值，再进行浮点数的运算操作。
BigDecimal a = new BigDecimal("1.0");
BigDecimal b = new BigDecimal("0.9");
BigDecimal c = new BigDecimal("0.8");
BigDecimal x = a.subtract(b);
BigDecimal y = b.subtract(c);
if (x.compareTo(y) == 0) {
System.out.println("true");
}
10. 【强制】如上所示 BigDecimal 的等值比较应使用 compareTo()方法，而不是 equals()方法。
说明：equals()方法会比较值和精度（1.0 与 1.00 返回结果为 false），而 compareTo()则会忽略精度。
11. 【强制】定义数据对象 DO 类时，属性类型要与数据库字段类型相匹配。
正例：数据库字段的 bigint 必须与类属性的 Long 类型相对应。
反例：某个案例的数据库表 id 字段定义类型 bigint unsigned，实际类对象属性为 Integer，随着 id 越来
越大，超过 Integer 的表示范围而溢出成为负数。
剩余62页未读，继续阅读
444 浏览量
425 浏览量
1113 浏览量
301 浏览量
2024-07-16 上传
138 浏览量
222 浏览量
