一、命名规范
【强制】不能以下划线(_)或者美元($)开始结尾 。反例:_name 、name_ 、$name、 name$
【强制】严禁使用中文拼音与英文混合命名,更不允许直接使用中文的方式。说明:正确的英文拼写和语法可以让阅读者更易理解,避免歧义。
【强制】类名使用UpperCamelaCase风格,必须遵守从驼峰式。以下例外(领域模型)DO、 BO、DTO、VO。正例MarcoPolo 、UserDO、 XmlService、TcpUdpDeal 等
【强制】方法名、参数名、成员变量名、局部变量名统一使用lowerCamelCase风格,必须遵守从驼峰形式。正例:localValue 、getHttpMessage() 、inputUserId
【强制】常量命名全部大写,单词间用下划线隔开,力求语义表达完整性,不要嫌弃太长。正例:MAX_STOCK_COUNT
【强制】抽象类命名使用Abstract或者Base开头。异常类命令使用Exception结尾。测试类使用Test结尾。
【强制】中括号是数组类型的一部分,数组定义:String[] args ;反例:String args[]。
【强制】pojo类中的布尔类型的变量,都不要加 is ,否则部分框架会引起序列化错误。反例:定义基本数据类型boolean isSuccess; 属性,它的的方法也是isSuccess(),RPC框架在做反向解析的时候,“以为”对应的属性名称是success。导致属性获取不到,进而抛出异常。
【强制】包名统一使用小写,点分隔符之间有且仅有一个自然语义英语单词。包名统一使用单数形式,但类名如果有复数含义,类名可使用复数形式。正例:应用工具类包名为 com.alibaba.open.util、类名为 MessageUtils(此规则参考
spring 的框架结构)
【强制】杜绝完全不规范的缩写,避免望文不知义。反例:AbstractClass“缩写”命名成AbsCess; condition "缩写"命名成comdi,此类随意缩写降低了代码的可阅性。
【推荐】如果使用到设计模式,建议在类名中体现出具体模式。正例:public class OrderFactory。
【推荐】接口类中方法和属性不要加任何的修饰符(public 也不要加),保持代码的简洁性,加上有效的javadoc注释。尽量不要在接口里定义变量,如果一定要定义变量,肯定需要与此接口相关,并且是此接口的应用基础变量。
说明:jdk8 接口中允许实现default方法,对所有实现类都有价值的默认实现。
接口和实现类两套规矩:
【强制】对于Service和DAO类,基于SOA理念,暴露出来的服务一定是接口,内部实现类用Impl的后缀与接口区别。正例:CacheServiceImpl实现CacheService接口。
【推荐】 如果是形容能力的接口名称,取对应的形容词做接口名(通常是-able的形式)。正例:AbstractTranslator 实现 Translatable 。
【参考】枚举类名建议带上Enum后缀,枚举成员名称需要全部大写,单词间使用下划线隔开。说明:枚举其实就是特殊的常量类,且构造方法被默认强制的是私有的。正例:枚举名字: DealStatusEnum, 成员名称: SUCCESS / UNKOWN_REASON。
【参考】各层命名规约:
A) Service/DAO 层方法命名规约
1) 获取单个对象的方法用 get 做前缀。
2) 获取多个对象的方法用 list 做前缀。
3) 获取统计值的方法用 count 做前缀。
4) 插入的方法用 save(推荐) 或 insert 做前缀。
5) 删除的方法用 remove(推荐) 或 delete 做前缀。
6) 修改的方法用 update 做前缀。
B) 领域模型命名规约
1) 数据对象: xxxDO, xxx 即为数据表名。
2) 数据传输对象: xxxDTO, xxx 为业务领域相关的名称。
3) 展示对象: xxxVO, xxx 一般为网页名称。
4) POJO 是 DO/DTO/BO/VO 的统称,禁止命名成 xxxPOJO。