阿里巴巴Java开发手册规范指南

阿里巴巴Java开发手册规范内部 阿里巴巴Java开发手册是阿里巴巴集团技术部编写的Java开发手册，旨在规范Java开发过程中的命名规约、编程风格、代码组织等方面。手册分为多个部分，包括编程规约、命名规约、编程风格、代码组织、异常处理等。 一、编程规约 1. 命名规约：所有编程相关命名均不能以下划线或美元符号开始，也不能以下划线或美元符号结束。例如：_name/__name/$Object/name_/name$/Object$均为不允许的命名方式。 2. 命名规约：所有编程相关的命名严禁使用拼音与英文混合的方式，更不允许直接使用中文的方式。例如：DaZhePromotion[打折]/getPingfenByName()[评分]/int变量=3;均为不允许的命名方式。 3. 命名规约：类名使用UpperCamelCase风格，必须遵从驼峰形式，但以下情形例外：（领域模型的相关命名）DO/DTO/VO/DAO等。例如：MarcoPolo/UserDO/XmlService/TcpUdpDeal/TaPromotion均为允许的命名方式。 4. 命名规约：方法名、参数名、成员变量、局部变量都统一使用lowerCamelCase风格，必须遵从驼峰形式。例如：localValue/getHttpMessage()/inputUserId均为允许的命名方式。 5. 命名规约：常量命名全部大写，单词间用下划线隔开，力求语义表达完整清楚，不要嫌名字长。例如：MAX_STOCK_COUNT均为允许的命名方式。 6. 命名规约：抽象类命名使用Abstract或Base开头；异常类命名使用Exception结尾；测试类命名以它要测试的类的名称开始，以Test结尾。 二、编程风格 1. 中括号是数组类型的一部分，数组定义如下：String[]args;。 2. POJO类中的任何布尔类型的变量，都不要加is，否则部分框架解析会引起序列化错误。 三、代码组织 1. 代码组织结构应清晰、简洁、易于阅读和维护。 2. 代码应遵从一定的编程风格和命名规约，以确保代码的一致性和可读性。 四、异常处理 1. 异常处理应遵从一定的规则和约定，确保代码的可靠性和稳定性。 2. 异常类命名应使用Exception结尾，以区别于其他类。 阿里巴巴Java开发手册提供了一个详细的规范和指南，旨在帮助Java开发者编写高质量、可维护的代码。遵从该手册的规范和指南，可以提高代码的可读性、可维护性和可靠性。