《Java开发手册》编程规约之常量定义与代码格式

銀花

(二) 常量定义
1. 【强制】不允许任何魔法值（即未经预先定义的常量）直接出现在代码中。
反例：

1. String key = "Id#taobao_" + tradeId;
   
2. cache.put(key, value);
   
3. // 缓存 get 时，由于在代码复制时，漏掉下划线，导致缓存击穿而出现问题

复制代码

2. 【强制】在 long 或者 Long 赋值时，数值后使用大写的 L，不能是小写的 l，小写容易跟数
字 1 混淆，造成误解。
说明：Long a = 2l; 写的是数字的 21，还是 Long 型的 2。


3. 【推荐】不要使用一个常量类维护所有常量，要按常量功能进行归类，分开维护。
说明：大而全的常量类，杂乱无章，使用查找功能才能定位到修改的常量，不利于理解和维护。
正例：缓存相关常量放在类 CacheConsts 下；系统配置相关常量放在类 ConfigConsts 下。


4. 【推荐】常量的复用层次有五层：跨应用共享常量、应用内共享常量、子工程内共享常量、
包内共享常量、类内共享常量。
1） 跨应用共享常量：放置在二方库中，通常是 client.jar 中的 constant 目录下。
2） 应用内共享常量：放置在一方库中，通常是子模块中的 constant 目录下。
反例：易懂变量也要统一定义成应用内共享常量，两位工程师在两个类中分别定义了“YES”的变量：
类 A 中：public static final String YES = "yes";
类 B 中：public static final String YES = "y";
A.YES.equals(B.YES)，预期是 true，但实际返回为 false，导致线上问题。
3） 子工程内部共享常量：即在当前子工程的 constant 目录下。
4） 包内共享常量：即在当前包下单独的 constant 目录下。
5） 类内共享常量：直接在类内部 private static final 定义。
5. 【推荐】如果变量值仅在一个固定范围内变化用 enum 类型来定义。
说明：如果存在名称之外的延伸属性应使用 enum 类型，下面正例中的数字就是延伸信息，表示一年中的
第几个季节。
正例：

1. public enum SeasonEnum {
   
2. SPRING(1), SUMMER(2), AUTUMN(3), WINTER(4);
   
3. private int seq;
   
4. SeasonEnum(int seq) {
   
5. this.seq = seq;
   
6. }
   
7. public int getSeq() {
   
8. return seq;
   
9. }
   
10. }

复制代码

(三) 代码格式
1. 【强制】如果是大括号内为空，则简洁地写成{}即可，大括号中间无需换行和空格；如果是非
空代码块则：
1） 左大括号前不换行。
2） 左大括号后换行。
3） 右大括号前换行。
4） 右大括号后还有 else 等代码则不换行；表示终止的右大括号后必须换行。


2. 【强制】左小括号和字符之间不出现空格；同样，右小括号和字符之间也不出现空格；而左
大括号前需要空格。详见第 5 条下方正例提示。
反例：if (空格 a == b 空格)


3. 【强制】if/for/while/switch/do 等保留字与括号之间都必须加空格。


4. 【强制】任何二目、三目运算符的左右两边都需要加一个空格。
说明：运算符包括赋值运算符=、逻辑运算符&&、加减乘除符号等。


5. 【强制】采用 4 个空格缩进，禁止使用 tab 字符。
说明：如果使用 tab 缩进，必须设置 1 个 tab 为 4 个空格。IDEA 设置 tab 为 4 个空格时，请勿勾选 Use
tab character；而在 eclipse 中，必须勾选 insert spaces for tabs。
正例： （涉及 1-5 点）

1. public static void main(String[] args) {
   
2. // 缩进 4 个空格
   
3. String say = "hello";
   
4. // 运算符的左右必须有一个空格
   
5. int flag = 0;
   
6. // 关键词 if 与括号之间必须有一个空格，括号内的 f 与左括号，0 与右括号不需要空格
   
7. if (flag == 0) {
   
8. System.out.println(say);
   
9. }
   
10. // 左大括号前加空格且不换行；左大括号后换行
    
11. if (flag == 1) {
    
12. System.out.println("world");
    
13. // 右大括号前换行，右大括号后有 else，不用换行
    
14. } else {
    
15. System.out.println("ok");
    
16. // 在右大括号后直接结束，则必须换行
    
17. }
    
18. }

复制代码

6. 【强制】注释的双斜线与注释内容之间有且仅有一个空格。
正例：

1. // 这是示例注释，请注意在双斜线之后有一个空格
   
2. String param = new String();Java 开发手册

复制代码

7. 【强制】在进行类型强制转换时，右括号与强制转换值之间不需要任何空格隔开。
正例：

1. long first = 1000000000000L;
   
2. int second = (int)first + 2;

复制代码

8. 【强制】单行字符数限制不超过 120 个，超出需要换行，换行时遵循如下原则：
1）第二行相对第一行缩进 4 个空格，从第三行开始，不再继续缩进，参考示例。
2）运算符与下文一起换行。
3）方法调用的点符号与下文一起换行。
4）方法调用中的多个参数需要换行时，在逗号后进行。
5）在括号前不要换行，见反例。
正例：

1. StringBuilder sb = new StringBuilder();
   
2. // 超过 120 个字符的情况下，换行缩进 4 个空格，点号和方法名称一起换行
   
3. sb.append("Jack").append("Ma")...
   
4. .append("alibaba")...
   
5. .append("alibaba")...
   
6. .append("alibaba");

复制代码

反例：

1. StringBuilder sb = new StringBuilder();
   
2. // 超过 120 个字符的情况下，不要在括号前换行
   
3. sb.append("Jack").append("Ma")...append
   
4. ("alibaba");
   
5. // 参数很多的方法调用可能超过 120 个字符，不要在逗号前换行
   
6. method(args1, args2, args3, ...
   
7. , argsX);

复制代码

9. 【强制】方法参数在定义和传入时，多个参数逗号后边必须加空格。
正例：下例中实参的 args1，后边必须要有一个空格。
method(args1, args2, args3);


10.【强制】IDE 的 text file encoding 设置为 UTF-8; IDE 中文件的换行符使用 Unix 格式，不
要使用 Windows 格式。


11.【推荐】单个方法的总行数不超过 80 行。
说明：除注释之外的方法签名、左右大括号、方法内代码、空行、回车及任何不可见字符的总行数不超过
80 行。
正例：代码逻辑分清红花和绿叶，个性和共性，绿叶逻辑单独出来成为额外方法，使主干代码更加清晰；
共性逻辑抽取成为共性方法，便于复用和维护。


12.【推荐】没有必要增加若干空格来使变量的赋值等号与上一行对应位置的等号对齐。
正例：

1. int one = 1;
   
2. long two = 2L;
   
3. float three = 3F;

复制代码

说明：增加 sb 这个变量，如果需要对齐，则给 one、two、three 都要增加几个空格，在变量比较多的情
况下，是非常累赘的事情。


13.【推荐】不同逻辑、不同语义、不同业务的代码之间插入一个空行分隔开来以提升可读性。
说明：任何情形，没有必要插入多个空行进行隔开。