第二天：第1章 编程规约 （1.2 常量定义 、 1.3 代码格式）

1.2 常量定义

①：【强制】不允许任何魔法值（即未经预先定一的常量）直接出现在代码中。

理解：例如项目中需要在 TextView内展示 “单价 50 元” ，那么如果这样写就不合适，主要还是因为后期修改不方便。

 

TextView.setText("单价 " + num + " 元");

③：不要使用一个常量类维护所有常量，要按常量功能进行归类，分开维护

正例：缓存相关常量放在类 CacheConsts 下；系统配置相关常量放在类 ConfigConsts下。

理解：这个就好理解，Consts -- 选择常量的意思，对于项目中英语单词的意思，可以使用插件 TranslationPlugin。

http://blog.csdn.net/qq_26030147/article/details/78817407

④：常量的复用层次有 5 层：跨应用共享常量、应用内共享常量、包内共享常量、类内共享常量。

1）跨应用共享常量：放置在二方库中，通常是在client.jar中的constant目录下

理解：constant 常数 常量

一方库：本工程中的各模块的相互依赖
二方库：公司内部的依赖库，一般指公司内部的其他项目发布的jar包
三方库：公司之外的开源库， 比如apache、ibm、google等发布的依赖
2）应用内共享常量：放置在一方库中，通常是在子模块中的constant目录下

反例：易懂变量也要统一定义成应用内共享常量，两位工程师在两个类中分别定义了表示 “是” 的变量：

类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 定义

⑤：【推荐】如果变量值仅在一个范围内变化， 则用enum类型来定义。

理解：如春夏秋冬 

扩展：enmu我认为挺好用的，对于单例模式来说，enum可以防止反编译，以及反序列化时候保证反序列化结果是同一对象。

1.3 代码格式

直接写例子，大部分的时候我们用格式化代码，与文中要求的一样，不过文中对注释的要求需要注意。

public static void main(String[] args) {
// 缩进 4 个空格，同时与 “//” 距离一个空格
String say = "hello"
// 运算符的左右必须有 1 个空格
int flag = 0;
// 关键词 if 与括号之间必须有 1 个空格，括号内的 flag 与左括号、0与右括号之间不需要空格
if (flag == 0) {
System.out.println(say);
}
// 左大括号前加空格且不换行; 左大括号后换行
if(flag == 1) {
System.out.println("world");
// 右大括号前换行，右大括号后有else，不用换行
} else {
System.out.println("ok");
// 在右大括号后直接结束，则必须换行
}
}

剩下的就是类似链表结构的，建造者模式那种，一直 .().().() 记得回车，还有注释超过120个字符换行缩进四个空格，不过话说谁会单行注释写120个字符。
还有是多个形参的方法的，那种的由于形参过多，可以在参数处换行，记得不要在逗号前换行。