一个源文件包含(按顺序地):
以上每个部分之间用一个空行隔开。
如果一个文件包含许可证或版权信息,那么它应当被放在文件最前面。
package语句不换行,列限制(4.4节)并不适用于package语句。(即package语句写在一行里)
即,不要出现类似这样的import语句:import java.util.*;
import语句不换行,列限制(4.4节)并不适用于import语句。(每个import语句独立成行)
import语句可分为以下几组,按照这个顺序,每组由一个空行分隔:
com.google
imports(仅当这个源文件是在com.google
包下)java
importsjavax
imports组内不空行,按字典序排列。
每个顶级类都在一个与它同名的源文件中(当然,还包含.java
后缀)。
例外:package-info.java
,该文件中可没有package-info
类。
类的成员顺序对易学性有很大的影响,但这也不存在唯一的通用法则。不同的类对成员的排序可能是不同的。 最重要的一点,每个类应该以某种逻辑去排序它的成员,维护者应该要能解释这种排序逻辑。比如, 新的方法不能总是习惯性地添加到类的结尾,因为这样就是按时间顺序而非某种逻辑来排序的。
当一个类有多个构造函数,或是多个同名方法,这些函数/方法应该按顺序出现在一起,中间不要放进其它函数/方法。