阿里巴巴Java开发规范手册详解

需积分: 0 7 下载量 195 浏览量 更新于2024-07-20 收藏 627KB PDF 举报
阿里巴巴Java开发规范手册(冰冰老湿版) 本手册是阿里巴巴集团技术部在2016年12月7日首次向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结尾。 二、编程规约 7. 编程规约:中括号是数组类型的一部分,数组定义如下:String[]args;例如:不要使用Stringargs[]的方式来定义。 8. 编程规约:POJO类中的任何布尔类型的变量,都不要加is,否则部分框架解析会引起序列化错误。例如:定义为基本数据类型booleanisSuccess;的属性,它们都是不允许的命名方式。 阿里巴巴Java开发规范手册(冰冰老湿版)对Java开发中的命名规约、编程规约、异常处理等方面提出了明确的规定,旨在提高代码的可读性、维护性和可扩展性。