阿里巴巴java开发手册

《阿里巴巴JAVA开发手册》是阿里巴巴集团技术部制定的一份针对Java编程的重要规范，旨在通过分享阿里集团的技术经验和教训，提供一套全球技术开发准则。这份手册包括了编程规约、异常处理、控制语句、注释规范等多个方面，旨在提高代码质量、可读性和维护性。 在**命名规约**中，手册强调了以下几点： 1. **命名规则**：禁止以下划线或美元符号开头或结尾，避免混合拼音和英文，也不应直接使用中文。如：`_name`, `__name`, `$Object`, `name_`, `name$`, `Object$`都是不被允许的。 2. **国际化命名**：避免使用拼音命名，推荐使用英文拼写和语法。例如：`DaZhePromotion`（打折）应改为`Discount`，`getPingfenByName()`（评分）改为`getScore()`，`int 变量 = 3;`改为`int variable = 3;`。 3. **类名**：应遵循UpperCamelCase风格，但DO/DTO/VO/DAO等例外。如：`MarcoPolo`, `UserDO`, `XmlService`, `TcpUdpDeal`, `TaPromotion`。 4. **方法名、参数名、成员变量、局部变量**：使用lowerCamelCase风格，如：`localValue`, `getHttpMessage()`, `inputUserId`。 5. **常量命名**：全大写，单词间用下划线分隔，如：`MAX_STOCK_COUNT`，避免简写如`MAX_COUNT`。 6. **抽象类和异常类命名**：抽象类以`Abstract`或`Base`开头，异常类以`Exception`结尾，测试类以待测类名+`Test`结尾。 7. **数组定义**：使用`[]`定义，如`String[] args`，避免使用`String args[]`。 8. **布尔变量**：避免以`is`开头，以免引起反序列化错误，如：`boolean isSuccess`的访问器应为`isSuccess()`，而非`isSuccess()`。 9. **包名**：小写，每个单词之间用点分隔，单数形式，如：`com.alibaba.mpp.util`，`MessageUtils`。 10. **避免不规范缩写**：如`AbsClass`（AbstractClass的缩写）和`condi`（condition的缩写）降低代码可读性。 11. **体现设计模式**：在类名中包含模式名称，帮助理解架构设计，如：`OrderFactory`, `LoginProxy`, `ResourceObserver`。 12. **接口定义**：接口方法不加访问修饰符，添加有效Javadoc注释。尽量避免在接口中定义变量，除非是基础常量，如：`void f();`，`String COMPANY = "alibaba";`。 13. **接口与实现类命名**：接口与实现类命名遵循SOA原则，服务接口不带Impl后缀，实现类带Impl，如：`CacheServiceImpl`实现`CacheService`接口。 这些规约的目的是提升代码的标准化和一致性，减少误解和错误，确保团队间的协作更加高效。遵循这些规范，能帮助开发者写出更专业、更易读、更易于维护的Java代码。