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天前
|
设计模式 安全 Java
Java编程中的单例模式:理解与实践
【10月更文挑战第31天】在Java的世界里,单例模式是一种优雅的解决方案,它确保一个类只有一个实例,并提供一个全局访问点。本文将深入探讨单例模式的实现方式、使用场景及其优缺点,同时提供代码示例以加深理解。无论你是Java新手还是有经验的开发者,掌握单例模式都将是你技能库中的宝贵财富。
19 2
|
9天前
|
JSON Java Apache
非常实用的Http应用框架,杜绝Java Http 接口对接繁琐编程
UniHttp 是一个声明式的 HTTP 接口对接框架,帮助开发者快速对接第三方 HTTP 接口。通过 @HttpApi 注解定义接口,使用 @GetHttpInterface 和 @PostHttpInterface 等注解配置请求方法和参数。支持自定义代理逻辑、全局请求参数、错误处理和连接池配置,提高代码的内聚性和可读性。
|
16天前
|
Java API Apache
Java编程如何读取Word文档里的Excel表格,并在保存文本内容时保留表格的样式?
【10月更文挑战第29天】Java编程如何读取Word文档里的Excel表格,并在保存文本内容时保留表格的样式?
71 5
|
11天前
|
安全 Java 编译器
JDK 10中的局部变量类型推断:Java编程的简化与革新
JDK 10引入的局部变量类型推断通过`var`关键字简化了代码编写,提高了可读性。编译器根据初始化表达式自动推断变量类型,减少了冗长的类型声明。虽然带来了诸多优点,但也有一些限制,如只能用于局部变量声明,并需立即初始化。这一特性使Java更接近动态类型语言,增强了灵活性和易用性。
93 53
|
10天前
|
存储 安全 Java
Java多线程编程的艺术:从基础到实践####
本文深入探讨了Java多线程编程的核心概念、应用场景及其实现方式,旨在帮助开发者理解并掌握多线程编程的基本技能。文章首先概述了多线程的重要性和常见挑战,随后详细介绍了Java中创建和管理线程的两种主要方式:继承Thread类与实现Runnable接口。通过实例代码,本文展示了如何正确启动、运行及同步线程,以及如何处理线程间的通信与协作问题。最后,文章总结了多线程编程的最佳实践,为读者在实际项目中应用多线程技术提供了宝贵的参考。 ####
|
7天前
|
监控 安全 Java
Java中的多线程编程:从入门到实践####
本文将深入浅出地探讨Java多线程编程的核心概念、应用场景及实践技巧。不同于传统的摘要形式,本文将以一个简短的代码示例作为开篇,直接展示多线程的魅力,随后再详细解析其背后的原理与实现方式,旨在帮助读者快速理解并掌握Java多线程编程的基本技能。 ```java // 简单的多线程示例:创建两个线程,分别打印不同的消息 public class SimpleMultithreading { public static void main(String[] args) { Thread thread1 = new Thread(() -> System.out.prin
|
9天前
|
存储 缓存 安全
在 Java 编程中,创建临时文件用于存储临时数据或进行临时操作非常常见
在 Java 编程中,创建临时文件用于存储临时数据或进行临时操作非常常见。本文介绍了使用 `File.createTempFile` 方法和自定义创建临时文件的两种方式,详细探讨了它们的使用场景和注意事项,包括数据缓存、文件上传下载和日志记录等。强调了清理临时文件、确保文件名唯一性和合理设置文件权限的重要性。
23 2
|
10天前
|
Java UED
Java中的多线程编程基础与实践
【10月更文挑战第35天】在Java的世界中,多线程是提升应用性能和响应性的利器。本文将深入浅出地介绍如何在Java中创建和管理线程,以及如何利用同步机制确保数据一致性。我们将从简单的“Hello, World!”线程示例出发,逐步探索线程池的高效使用,并讨论常见的多线程问题。无论你是Java新手还是希望深化理解,这篇文章都将为你打开多线程的大门。
|
10天前
|
安全 Java 编译器
Java多线程编程的陷阱与最佳实践####
【10月更文挑战第29天】 本文深入探讨了Java多线程编程中的常见陷阱,如竞态条件、死锁、内存一致性错误等,并通过实例分析揭示了这些陷阱的成因。同时,文章也分享了一系列最佳实践,包括使用volatile关键字、原子类、线程安全集合以及并发框架(如java.util.concurrent包下的工具类),帮助开发者有效避免多线程编程中的问题,提升应用的稳定性和性能。 ####
38 1
|
14天前
|
存储 设计模式 分布式计算
Java中的多线程编程:并发与并行的深度解析####
在当今软件开发领域,多线程编程已成为提升应用性能、响应速度及资源利用率的关键手段之一。本文将深入探讨Java平台上的多线程机制,从基础概念到高级应用,全面解析并发与并行编程的核心理念、实现方式及其在实际项目中的应用策略。不同于常规摘要的简洁概述,本文旨在通过详尽的技术剖析,为读者构建一个系统化的多线程知识框架,辅以生动实例,让抽象概念具体化,复杂问题简单化。 ####