代码编写规范

OOP规范

1. 【强制】避免通过一个类的对象引用访问此类的静态变量或静态方法，无谓增加编译器解析成本，直接用类名来访问即可。
2. 【强制】所有的覆写方法，必须加@Override注解。
3. 【强制】相同参数类型，相同业务含义，才可以使用Java的可变参数，避免使用Object。
4. 【强制】外部正在调用或者二方库依赖的接口，不允许修改方法签名，避免对接口调用方产生影响。接口过时必须加@Deprecated注解，并清晰地说明采用的新接口或者新服务是什么。
5. 【强制】不能使用过时的类或方法。
6. 【强制】Object的equals方法容易抛出空指针异常，应使用常量或有确定值的对象来调用equals。
7. 【强制】所有整形包装类对象之间值的比较，全部使用equals方法比较。
8. 【强制】任何货币金额，均以最小货币单位且整形类型来进行存储。
9. 【强制】浮点数之间的等值判断，基本数据类型不能用==来比较，包装数据类型不能用equals来判断。
   说明：浮点数采用“尾数+阶码”的编码方式，类似于科学计数法的“有效数字+指数”的表示方式。二进制无法精确表示大部分的十进制小数。
   反例：

float a = 1.0f - 0.9f;
float b = 0.9f - 0.8f;
if(a == b){
	// a==b的结果为false
}

Float x = Float.valueOf(a);
Float y = Float.valueOf(b);
if(x.equals(y)){
	// equals的结果为false
}

正例：

// （1）指定一个误差范围，两个浮点数的差值在此范围之内，则认为是相等的。
float a = 1.0f - 0.9f;
float b = 0.9f - 0.8f;
float diff = 1e-6f;
if(Math.abs(a-b) < diff){
	System.out.println("true");
}

// （2）使用BigDecimal来定义值，在进行浮点数的运算操作。
BigDecimal a = new BigDecimal("1.0");
BigDecimal a = new BigDecimal("0.9");
BigDecimal a = new BigDecimal("0.8");

BigDecimal x = a.subtract(b);
BigDecimal y = b.subtract(c);
if(x.equals(y)){
	System.out.println("true");
}

10. 【强制】定义数据对象DO类时，属性类型要与数据库字段类型相匹配。
11. 【强制】禁止使用构造方法BigDecimal(double)的方式把double值转化为BigDecimal对象。
    说明:BigDecimal(double)存在精度损失风险，在精确计算或值比较的场景中可能会导致业务逻辑异常。如：BigDecimal g = new BigDecimal(0.1f);实际的存储值为：0.10000000149
    正例:优先推荐入参为String的构造方法，或使用BigDecimal的valueOf方法，此方法内部执行了Double的toString，而Double的toString按double的实际能表达的精度对尾数进行截断。

BigDecimal recommend1 = new BigDecimal("0.1");
BigDecimal recommend2 = BigDecimal.valueOf(0.1);

12. 关于基本数据类型与包装数据类型的使用标准如下:
    (1)【强制】所有的POJO类属性必须使用包装数据类型。
    (2)【强制】RPC方法的返回值和参数必须使用包装数据类型。
    (3)【推荐】所有的局部变量使用基本数据类型。

13.【强制】定义DO/DTO/VO等POJO类时，不要设定任务属性默认值。
14.【强制】序列化类新增属性时，请不要修改serialVersionUID字段，避免反序列化失败；如果完全不兼容升级，避免反序列化混乱，那么请修改serialVersionUID值。
15.【强制】构造方法里面禁止加入任何业务逻辑，如有初始化逻辑，请放在init方法中。
16.【强制】POJO类必须写toString方法。
17.【强制】禁止在POJO类中，同时存在对应属性xxx的isXxx()和getXxx()方法。