阿里巴巴Java开发手册(第2版)-第1章(1)

简介: 本章是传统意义上的代码规范,包括变量命名、代码风格、控制语句、代码注释、前后端规约等基本的编程习惯,以及从高并发场景中提炼出来的集合处理技巧与并发多线程的注意事项。

第1章  编程规约

1.1 命名风格

1

【强制】代码中的命名均不能以下画线或美元符号开始,也不能以下画线或美元符号结束。

反例:_name / __name / $name / name_ / name$ / name__

2

【强制】所有编程相关的命名严禁使用拼音与英文混合的方式,更不允许直接使用中文的方式。

说明:正确的英文拼写和语法可以让阅读者易于理解,避免歧义。注意,

纯拼音命名方式更要避免采用。

正例:ali / alibaba / taobao / cainiao/ aliyun/ youku /

hangzhou 等国际通用的名称,可视同英文。

反例:DaZhePromotion [打折] / getPingfenByName() [评分] /

String fw[福娃] / int 某变量 = 3

3

【强制】代码和注释中都要避免使用(任何人类语言的)涉及性别、种族、地域、特定人群等的歧视性词语。

4

【强制】类名使用UpperCamelCase 风格,但以下情形例外:

DO / BO / DTO / VO / AO / PO / UID 等。

正例:ForceCode / UserDO / HtmlDTO / XmlService /

TcpUdpDeal / TaPromotion

反例:forcecode / UserDo / HTMLDto / XMLService /

5

【强制】方法名、参数名、成员变量、局部变量都统一使用lowerCamelCase 风格。

正例:localValue / getHttpMessage() / inputUserId

6

【强制】常量命名全部大写,单词间用下画线隔开,力求语义表达完整清楚,不要嫌名字长。

正例:MAX_STOCK_COUNT / CACHE_EXPIRED_TIME

反例:MAX_COUNT / EXPIRED_TIME

7

【强制】抽象类命名使用Abstract 或Base 开头;异常类命名使用Exception 结尾;测试类命名以它要测试的类的名称开始,以Test 结尾。

8

【强制】类型与中括号相连定义数组。

正例:定义整形数组int[] arrayDemo;

反例:在main 参数中,使用String args[]来定义。

9

【强制】POJO 类中的任何布尔类型的变量,都不要加is 前缀,否则部分框架解析会引起序列化错误。

说明:5.1 节“建表规约”中的第1条,表达是与否概念的变量采用is_xxx 的命名方式,所以,需要在<resultMap>设置从is_xxx到xxx 的映射关系。

反例:定义为基本数据类型Boolean isDeleted 的属性,它的方法也是isDeleted(),框架在反向解析的时候,“误以为”对应的属性名称是deleted,导致获取不到属性,进而抛出异常。

10

【强制】包名统一使用小写,点分隔符之间有且仅有一个自然语义的英语单词。包名统一使用单数形式,但是类名如果有复数含义,则类名可以使用复数形式。

正例:应用工具类包名为com.alibaba.ei.kunlun.aap.util、类名为MessageUtils(此规则参考Spring 的框架结构)。

11

【强制】避免在子父类的成员变量之间或者不同代码块的局部变量之间采用完全相同的命名,降低可理解性。

说明:子类成员、父类成员变量名相同,即使是public 类型的变量也能够通过编译。虽然局部变量在同一方法内的不同代码块中同名是合法的,但是要避免使用。对于非setter/getter 的参数名称,也要避免与成员变量名称相同。

反例:

public class ConfusingName {

      public int stock;

      // 非setter/getter 的参数名称

      // 不允许与本类成员变量同名

      public void get(String alibaba) {

             if (condition) {

                  final int money = 666;

                  // ...

             }

             for (int i = 0; i < 10; i++) {

                  // 在同一方法体中,不允许与其他代码块中的

                 // money 命名相同

                 final int money = 15978;

                // ...

             }

      }

}

class Son extends ConfusingName {

      // 不允许与父类的成员变量名称相同

      public int stock;

}

12

【强制】杜绝完全不规范的缩写,避免望文不知义。

反例:AbstractClass“缩写”成AbsClass,condition“缩写”成condi,Function“缩写”成Fu,此类随意缩写严重降低了代码的可读性。

13

【推荐】为了实现代码自解释的目标,在命名任何自定义编程元素时,都尽量使用完整的单词组合来表达。

正例:在JDK 中,对某个对象引用的volatile 字段进行原子更新的类名为AtomicReferenceFieldUpdater。

反例:常见的方法内变量为int a;的定义方式。

14

【推荐】在命名常量与变量时,表示类型的名词放在词尾,以提升辨识度。

正例:startTime / workQueue / nameList

反例:startedAt / QueueOfWork / listName

15

【推荐】如果模块、接口、类和方法使用了设计模式,在命名时需体现出具体模式。

说明:将设计模式体现在名字中,有利于阅读者快速理解架构的设计理念。

正例:

   public class OrderFactory;

   public class LoginProxy;

   public class ResourceObserver;

16

【推荐】接口类中的方法和属性不要加任何修饰符号(public 也不要加),保持代码的简捷性,并加上有效的Javadoc 注释。尽量不要在接口里定义变量,如果一定要定义变量,确定与接口方法相关,并且是整个应用的基础常量。

正例:接口方法签名 void commit();

         接口基础常量 String COMPANY = "alibaba";

反例:接口方法定义 public abstract void f();

说明:JDK 8 中接口允许有默认实现,那么这个default 方法,是对所有实现类都有价值的默认实现。

17

接口和实现类的命名有两套规则。

1)【强制】对于Service 和DAO 类,基于SOA 的理念,暴露出来的服务一定是接口,内部的实现类用Impl 的后缀与接口区别。

正例:CacheServiceImpl 实现CacheService 接口。

2)【推荐】如果是形容能力的接口名称,取对应的形容词为接口名(通常是–able 的形容词)。

正例:AbstractTranslator 实现 Translatable 接口。

18

【参考】枚举类名带上Enum 后缀,枚举成员名称需要全部大写,单词间用下画线隔开。

说明:枚举其实就是特殊的常量类,且构造方法被默认强制为私有。

正例:枚举名字为ProcessStatusEnum 的成员名称为SUCCESS /UNKNOWN_REASON。

19

【参考】各层命名规约:

1)Service/DAO 层方法命名规约如下。

  • 获取单个对象的方法用get 作为前缀。
  • 获取多个对象的方法用list 作为前缀,复数结尾,如listObjects。
  • 获取统计值的方法用count 作为前缀。
  • 插入的方法用save/insert 作为前缀。
  • 删除的方法用remove/delete 作为前缀。
  • 修改的方法用update 作为前缀。

2)领域模型命名规约如下。

  • 数据对象:xxxDO,xxx 即数据表名。
  • 数据传输对象:xxxDTO,xxx 为业务领域相关的名称。
  • 展示对象:xxxVO,xxx 一般为网页名称。
  • POJO 是DO/DTO/BO/VO 的统称,禁止命名成xxxPOJO。
目录
打赏
0
0
0
0
28
分享
相关文章
|
4月前
|
如何使用Java开发抖音API接口?
在数字化时代,社交媒体平台如抖音成为生活的重要部分。本文详细介绍了如何用Java开发抖音API接口,从创建开发者账号、申请API权限、准备开发环境,到编写代码、测试运行及注意事项,全面覆盖了整个开发流程。
621 10
一天成为Java开发高手:用飞算JavaAI实现十倍提效
“一天成为Java开发高手”曾被视为天方夜谭,但飞算JavaAI的出现改变了这一局面。这款AI开发助手通过智能引导、需求分析、自动化逻辑处理和完整代码工程生成,大幅简化了Java开发流程。它不仅帮助新手快速上手,还让资深开发者提高效率,减少调试时间。现在,参与“飞算JavaAI炫技赛”,展示你的开发实力,赢取丰厚奖品!
如何使用Java语言快速开发一套智慧工地系统
使用Java开发智慧工地系统,采用Spring Cloud微服务架构和前后端分离设计,结合MySQL、MongoDB数据库及RESTful API,集成人脸识别、视频监控、设备与环境监测等功能模块,运用Spark/Flink处理大数据,ECharts/AntV G2实现数据可视化,确保系统安全与性能,采用敏捷开发模式,提供详尽文档与用户培训,支持云部署与容器化管理,快速构建高效、灵活的智慧工地解决方案。
智慧产科一体化管理平台源码,基于Java,Vue,ElementUI技术开发,二开快捷
智慧产科一体化管理平台覆盖从备孕到产后42天的全流程管理,构建科室协同、医患沟通及智能设备互联平台。通过移动端扫码建卡、自助报道、智能采集数据等手段优化就诊流程,提升孕妇就诊体验,并实现高危孕产妇五色管理和孕妇学校三位一体化管理,全面提升妇幼健康宣教质量。
44 12
Java高级应用开发:基于AI的微服务架构优化与性能调优
在现代企业级应用开发中,微服务架构虽带来灵活性和可扩展性,但也增加了系统复杂性和性能瓶颈。本文探讨如何利用AI技术,特别是像DeepSeek这样的智能工具,优化Java微服务架构。AI通过智能分析系统运行数据,自动识别并解决性能瓶颈,优化服务拆分、通信方式及资源管理,实现高效性能调优,助力开发者设计更合理的微服务架构,迎接未来智能化开发的新时代。
菜鸟之路day02-04拼图小游戏开发一一JAVA基础综合项目
本项目基于黑马程序员教程,涵盖面向对象进阶、继承、多态等知识,历时约24小时完成。项目去除了登录和注册模块,专注于单机游戏体验。使用Git进行版本管理,代码托管于Gitee。项目包含窗体搭建、事件监听、图片加载与打乱、交互逻辑实现、菜单功能及美化界面等内容。通过此项目,巩固了Java基础并提升了实际开发能力。 仓库地址:[https://gitee.com/zhang-tenglan/puzzlegame.git](https://gitee.com/zhang-tenglan/puzzlegame.git)
46 6
【潜意识Java】javaee中的SpringBoot在Java 开发中的应用与详细分析
本文介绍了 Spring Boot 的核心概念和使用场景,并通过一个实战项目演示了如何构建一个简单的 RESTful API。
47 5
Java后端开发-使用springboot进行Mybatis连接数据库步骤
本文介绍了使用Java和IDEA进行数据库操作的详细步骤,涵盖从数据库准备到测试类编写及运行的全过程。主要内容包括: 1. **数据库准备**:创建数据库和表。 2. **查询数据库**:验证数据库是否可用。 3. **IDEA代码配置**:构建实体类并配置数据库连接。 4. **测试类编写**:编写并运行测试类以确保一切正常。
70 2

热门文章

最新文章