Java编程规约(源于阿里,精简版)

简介: Java编程规约(源于阿里,精简版)

一、命名风格

(1)代码中的命名均不能以下划线或美元符号开始,也不能以下划线或美元符号结束


       反例:_name / name$


(2)代码中的命名严禁使用拼音与英文混合的方式,更不允许直接使用中文的方式


       正例:alibaba / taobao / youku / hangzhou 等国际通用的名称,可视同英文


       反例:getPingfenByName() [评分] / int 价格 = 3


(3)类名使用大驼峰命名法


       正例:MarcoPolo / UserDO


(4)方法名、参数名、成员变量、局部变量使用小驼峰命名法


       正例: localValue / getHttpMessage()


(5)包名统一用小写


       正例: com.alibaba.open.util


(6)常量命名全部大写,单词间用下划线隔开


       正例:MAX_STOCK_COUNT


(7)抽象类命名使用 Abstract 或 Base 开头;


        异常类命名使用Exception结尾;


        测试类的命名要以它要测试的类的名称开始,以Test结尾


(8)定义数组的时候,应该 String[ ] args  ,而不 String args[ ]


(9)POJO 类中布尔类型的变量,都不要加 is,否则部分框架解析会引起序列化错误


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


命名风格总结:


       命名的目标就是让人见名知义,因此要先统一格式,比如,看到大驼峰命名就知道是个类名,并且还需要让人知道是个什么类,所以在命名的时候应该避开不适当的缩写、拼音与英文混用 等问题


     


二、代码书写规范

       如果使用IDEA进行开发,可以直接使用快捷键 Ctrl+Alt+L 进行代码格式化,格式化遵循以下的准则


(1)大括号的使用约定。如果大括号内为空,直接写为{}即可;如果大括号内不空则:


左大括号前部换行

左大括号后换行

右大括号前换行

右大括号后还有 else 等代码则不换行;表示终止的右大括号后必须换行

(2)一句格式化的代码:if[空格](a[空格]==[空格]b)


    该实例可映射出如下规范:


if / for / while / switch / do 等保留字与括号之间都必须加空格

任何二目、三目运算符的左右两边都需要加一个空格 ( == 为二目运算符 )

左小括号和字符之间不出现空格;同样,右小括号和字符之间也不出现空格

(3)注释的双斜线与注释内容之间有且仅有一个空格


       正例://[空格]注释内容


(4)方法参数在定义和传入时,多个参数逗号后边必须加空格


       正例:method("a",[空格]"b",[空格]"c")


以上是代码格式化能帮我们完成的,此外,我们还要遵循如下准则


(1)采用 4 个空格缩进,禁止使用 tab 字符


       如果使用 tab 缩进,必须设置1个 tab 为4个空格。IDEA设置 tab 为4个空格时,不能勾选Use tab character


(2)单行字符数限制不超过 120 个,超出需要换行,换行时遵循如下原则:


第二行相对第一行缩进 4 个空格,从第三行开始,不再继续缩进,参考示例

运算符与下文一起换行

方法调用时,多个参数,需要换行时,在逗号后进行

在括号前不要换行,见反例


(3)IDE 的 text file encoding 设置为 UTF-8;IDE 中文件的换行符使用 Unix 格式,不要使用Windiws 格式


三、OOP(面向对象编程)规约

(1)避免通过一个类的对象引用访问此类的静态变量或静态方法,直接用类名来访问即可


(2)相同参数类型,相同业务含义,才可以使用 Java 的可变参数,并且可变参数必须放置在参数列表的最后(提倡尽量不用可变参数编程)


(3)Object 的 equals 方法容易抛空指针异常,应使用常量或确定有值的对象来调用 equals 方法


       正例:"test".equals(object)


       反例:object.equals("test")


(4)所有的相同类型的包装类对象之间值的比较,全部使用 equals 方法比较,为的是避免128陷阱


(5)构造方法里面禁止加入任何业务逻辑,如果有初始化逻辑,请放在 init 方法中


(6)对于POJO类(可以简单的理解为实体类)的规范


所有的 POJO 类属性必须使用包装数据类型

定义 DO/DTO/VO 等 POJO 类时,不要设定任何属性默认值

POJO 类必须写 toString 方法。使用 IDE 的中工具:source> generate toString时,如果继承了另一个 POJO 类,注意在前面加一下 super.toString

四、集合使用

(1)只要重写 equals,就必须重写 hashCode


       原因:因为 Set 存储的是不重复的对象,依据 hashCode 和 equals 进行判断,所以 Set 存储的对象必须重写这两个方法


       如果自定义对象做为 Map 的键,那么必须重写 hashCode 和 equals


       String 重写了hashCode 和 equals 方法,所以我们可以非常愉快地使用 String 对象作为 key 来使用


(2)ArrayList的subList结果不可强转成ArrayList,否则会抛出ClassCastException异常


       说明:subList 返回的是 ArrayList 的内部类 SubList,并不是 ArrayList ,而是ArrayList 的一个视图,对于 SubList 子列表的所有操作最终会反映到原列表上


(3)使用集合转数组的方法,必须使用集合的 toArray(T[] array),传入的是类型完全一样的数组,大小就是 list.size()


例子:

List<String> list = new ArrayList<String>(2); 
list.add("guan"); 
list.add("bao"); 
String[] array = new String[list.size()]; 
array = list.toArray(array)

(4)使用工具类 Arrays.asList()把数组转换成集合时,不能使用其修改集合相关的方法,它的add / remove / clear 方法会抛出 UnsupportedOperationException 异常


       原因:asList 的返回对象是一个 Arrays 内部类,并没有实现集合的修改方法      


(5)泛型通配符<? extends T>来接收返回的数据,此写法的泛型集合不能使用 add 方法,而<? super T>不能使用 get 方法,做为接口调用赋值时易出错


(6)不要在 foreach 循环里进行元素的 remove/add 操作。remove 元素请使用 Iterator方式,如果并发操作,需要对 Iterator 对象加锁

正例:
Iterator<String> iterator = list.iterator(); 
while (iterator.hasNext()) { 
    String item = iterator.next(); 
    if (删除元素的条件) { 
        iterator.remove(); 
    } 
}
反例:
List<String> list = new ArrayList<String>(); 
list.add("1"); 
list.add("2"); 
for (String item : list) { 
    if ("1".equals(item)) { 
        list.remove(item); 
    } 
}

(7)在 JDK7 版本及以上,Comparator 要满足如下三个条件,不然 Arrays.sort,Collections.sort 会报 IllegalArgumentException 异常


三个条件如下:


x,y 的比较结果和 y,x 的比较结果相反

x>y,y>z,则 x>z

x=y,则 x,z 比较结果和 y,z 比较结果相同

       反例: 下例中没有处理相等的情况,实际使用中可能会出现异常

new Comparator<Student>() { 
    @Override 
    public int compare(Student o1, Student o2) { 
        return o1.getId() > o2.getId() ? 1 : -1; 
    } 
};

五、注释规范

(1)类、类属性、类方法的注释必须使用/**内容*/格式,不得使用// xxx 方式


(2)所有的抽象方法(包括接口中的方法)必须要用 Javadoc 注释、除了返回值、参数、异常说明外,还必须指出该方法做什么事情,实现什么功能


(3)所有的类都必须添加创建者和创建日期


(4)方法内部单行注释,在被注释语句上方另起一行,使用//注释。方法内部多行注释使用/* */注释,注意与代码对齐所有的枚举类型字段必须要有注释,说明每个数据项的用途


(5)所有的枚举类型字段必须要有注释,说明没个数据项的用途


六、并发处理

(1)线程资源必须通过线程池提供,不允许在应用中自行显式创建线程


       原因:使用线程池的好处是减少在创建和销毁线程上所花的时间以及系统资源的开销,解决资 源不足的问题。如果不使用线程池,有可能造成系统创建大量同类线程而导致消耗完内存或者 “过度切换”的问题


(2)高并发时,同步调用应该去考量锁的性能损耗。能用无锁数据结构,就不要用锁;能 锁区块,就不要锁整个方法体;能用对象锁,就不要用类锁


(3)对多个资源、数据库表、对象同时加锁时,需要保持一致的加锁顺序,否则可能会造成死锁


(4)并发修改同一记录时,避免更新丢失,需要加锁。要么在应用层加锁,要么在缓存加锁,要么在数据库层使用乐观锁,使用 version 作为更新依据


(5)线程池不允许使用 Executors 去创建,而是通过 ThreadPoolExecutor 的方式,这样的处理方式让写的同学更加明确线程池的运行规则,规避资源耗尽的风险


       说明:Executors 返回的线程池对象的弊端如下


FixedThreadPool 和 SingleThreadPool:允许的请求队列长度为 Integer.MAX_VALUE,可能会堆积大量的请求,从而导致 OOM。

CachedThreadPool 和 ScheduledThreadPool:允许的创建线程数量为 Integer.MAX_VALUE,可能会创建大量的线程,从而导致 OOM。

七、其他规范

(1)在一个 switch 块内,每个 case 要么通过 break/return 等来终止,要么注释说明程序将继续执行到哪一个 case 为止;在一个 switch 块内,都必须包含一个 default 语句并且放在最后,即使它什么代码也没有


(2)任何数据结构的构造或初始化,都应指定大小,避免数据结构无限增长吃光内存


(3)注意 Math.random() 这个方法返回是 double 类型,注意取值的范围 0≤x<1(能够取到零值,注意除零异常),如果想获取整数类型的随机数,不要将 x 放大 10 的若干倍然后取整,直接使用 Random 对象的 nextInt 或者 nextLong 方法


       正例:随机生成[0,8]区间的整数


       Random random = new Random();


       int num = random.nextInt(9);


(4)获取当前毫秒数 System.currentTimeMillis(); 而不是 new Date().getTime(),如果想获取更加精确的纳秒级时间值,使用 System.nanoTime()的方式


目录
相关文章
|
13天前
|
SQL Java 数据库
2025 年 Java 从零基础小白到编程高手的详细学习路线攻略
2025年Java学习路线涵盖基础语法、面向对象、数据库、JavaWeb、Spring全家桶、分布式、云原生与高并发技术,结合实战项目与源码分析,助力零基础学员系统掌握Java开发技能,从入门到精通,全面提升竞争力,顺利进阶编程高手。
203 1
|
3月前
|
Java API 微服务
为什么虚拟线程将改变Java并发编程?
为什么虚拟线程将改变Java并发编程?
263 83
|
2月前
|
安全 Java 数据库连接
2025 年最新 Java 学习路线图含实操指南助你高效入门 Java 编程掌握核心技能
2025年最新Java学习路线图,涵盖基础环境搭建、核心特性(如密封类、虚拟线程)、模块化开发、响应式编程、主流框架(Spring Boot 3、Spring Security 6)、数据库操作(JPA + Hibernate 6)及微服务实战,助你掌握企业级开发技能。
272 3
|
14天前
|
Java 开发者
Java并发编程:CountDownLatch实战解析
Java并发编程:CountDownLatch实战解析
301 100
|
18天前
|
人工智能 Java 开发者
阿里出手!Java 开发者狂喜!开源 AI Agent 框架 JManus 来了,初次见面就心动~
JManus是阿里开源的Java版OpenManus,基于Spring AI Alibaba框架,助力Java开发者便捷应用AI技术。支持多Agent框架、网页配置、MCP协议及PLAN-ACT模式,可集成多模型,适配阿里云百炼平台与本地ollama。提供Docker与源码部署方式,具备无限上下文处理能力,适用于复杂AI场景。当前仍在完善模型配置等功能,欢迎参与开源共建。
582 58
阿里出手!Java 开发者狂喜!开源 AI Agent 框架 JManus 来了,初次见面就心动~
|
1月前
|
算法 Java
Java多线程编程:实现线程间数据共享机制
以上就是Java中几种主要处理多线程序列化资源以及协调各自独立运行但需相互配合以完成任务threads 的技术手段与策略。正确应用上述技术将大大增强你程序稳定性与效率同时也降低bug出现率因此深刻理解每项技术背后理论至关重要.
82 16
|
24天前
|
NoSQL Java 关系型数据库
超全 Java 学习路线,帮你系统掌握编程的超详细 Java 学习路线
本文为超全Java学习路线,涵盖基础语法、面向对象编程、数据结构与算法、多线程、JVM原理、主流框架(如Spring Boot)、数据库(MySQL、Redis)及项目实战等内容,助力从零基础到企业级开发高手的进阶之路。
128 1
|
2月前
|
安全 算法 Java
Java泛型编程:类型安全与擦除机制
Java泛型详解:从基础语法到类型擦除机制,深入解析通配符与PECS原则,探讨运行时类型获取技巧及最佳实践,助你掌握泛型精髓,写出更安全、灵活的代码。
|
2月前
|
安全 Java Shell
Java模块化编程(JPMS)简介与实践
本文全面解析Java 9模块化系统(JPMS),帮助开发者解决JAR地狱、类路径冲突等常见问题,提升代码的封装性、性能与可维护性。内容涵盖模块化核心概念、module-info语法、模块声明、实战迁移、多模块项目构建、高级特性及最佳实践,同时提供常见问题和面试高频题解析,助你掌握Java模块化编程精髓,打造更健壮的应用。