0524泰山版java开发手册

Posted 2021-02-18 alin002

三.代码格式

　　6.注释的双斜线和注释内容之间有且仅有一个空格

　　7.再进行强制类型转换时,右括号与强制转换值之间不需要任何空格隔开

　　8.单行字符数限制不超过120个,超出需要换行,换行时遵循如下规则:

1)第二行相对第一行缩进四个空格,从第三行开始,不再继续缩进

2)运算符与下文一起换行

3)方法调用的点符号与下文一起换行

4)方法调用中的多个参数需要换行时,在逗号后进行

5)在括号前不要换行

　　9.方法参数在定义和传入时,多个参数逗号后边必须加空格

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

　　11.单个方法的总行数不超过80行

四.OOP规约(面向对象编程)

　　1.避免通过一个类对象引用访问此类的静态变量或静态方法,无谓增加编译器解析成本,直接使用类名来访问即可

　　2.所有的覆写方法,必须加@Override注解

1) 访问父类构造方法

super(); // 无参数

super(name);   // 有参数

2) 访问父类属性

super.name;

3) 访问父类方法

super.print();

　　3.相同参数类型,相同业务含义,才可以使用Java的可变参数,避免使用Object(尽量不用可变参数编程)

一个方法只能有一个可变长参数，并且这个可变长参数必须是该方法的最后一个参数

public void print(String... args) {
        for (int i = 0; i < args.length; i++) {
            out.println(args[i]);
        }
}

　　4.外部正在调用或者二方库依赖的接口,不允许修改方法签名,避免对接口调用方产生影响.接口过时必须加@Deprecated注解,并清晰的说明采用的新接口或者新服务是什么

若某类或某方法加上该注解之后，表示此方法或类不再建议使用，调用时也会出现删除线，但并不代表不能用，只是说，不推荐使用，因为还有更好的方法可以调用。

　　5.不能使用过时的类或方法

　　6.Object的equals方法容易抛出空指针异常,应使用常量或确定有值的对象来调用equals

例如:"test".equals(object);   /   object.equals("test")

　　7.所有整型包装类对象之间值的比较,全部使用equals方法比较

　　8.任何货币金额,均以最小货币单位且整型类型来进行存储

　　9.浮点数之间的等值判断,基本数据类型不能用==来比较,包装数据类型不能用equals来判断

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 b= new BigDecimal("0.9");
 BigDecimal c= new BigDecimal("0.8");
 
 BigDecimal x=a.subtract(b);
 BigDecimal y=b.subtract(c);

 if(x.equals(y)){
     System.out.println("true");
}

BigDecimal尽量使用参数类型为String的构造函数。

BigDecimal都是不可变的，在进行每一步运算时，都会产生一个新的对象，所以在做加减乘除运算时千万要保存操作后的值。

　　10.定义数据对象DO类时,属性类型要与数据库字段类型相匹配

　　11.关于基本数据类型与包装数据类型的使用标准如下:

1) 所有的POJO类属性必须使用包装数据类型(POJO类只能装载数据,作为数据存储的载体)

2)RPC方法的返回值和参数必须使用包装数据类型

3)所有的局部变量使用基本数据类型

　　12.定义DO/DTO/VO等POJO类时,不要设定任何属性默认值

　　13.序列化类新增属性时,请不要修改serialVersionUID字段,避免反序列失败;如果完全不兼容升级,避免反序列化混论,那么请修改serialVersionUID值

　　14.构造方法里面禁止加入任何业务逻辑,如果有初始化逻辑,请放在init方法中

　　15.POJO类必须写toString方法.使用IDE中的工具:source->generate toString时,如果继承了另一POJO类,注意在前面加一下super.toString

　　16.禁止在POJO类中,同时存在对应属性xxx的isXxx()和getXxx()方法

　　17.类内方法定义的顺序依次是:公有方法或保护方法 > 私有方法 > getter/setter方法

　　18.在getter/setter方法中,不要增加业务逻辑

　　19.循环体内,字符串的连接方式,使用StringBuilder的append方法进行拓展

　　20.final可以声明类,成员变量,方法,以及本地变量,下列情况使用final关键字

1) 不允许被继承的类,如:String类

2) 不允许修改引用的域对象,如:POJO类的与变量

3)不允许被覆写的方法,如:POJO类的setter方法

4)不允许运行过程中重新赋值的局部变量

5)避免上下文重复使用一个变量,使用final可以强制重新定义一个变量,方便更好重构

　　21.类成员与方法访问控制从严:

1)如果不允许外部直接通过new来创建对象,那么构造方法必须是private

2)工具类不能须有public或default构造方法

3)类非static成员变量并且与子类共享,必须是protected

4)类非static成员变量并且仅在本类使用,必须是private

5)类static成员变量如果仅在本类使用,必须是private

6)若是static成员变量,考虑是否为final

7)类成员方法只供内部调用,必须是private

8)类成员方法只对继承类公开,那么限制为protected

五.日期时间

　　1.日期格式化时,传入pattern中表示年份统一使用小写的y

　　2.在日期格式中分清楚大写的M和小写的m,大写的H和小写的h分别指代的意义

1)表示月份是大写的M

2)表示分钟是小写的m

3)24小时制的是大写的H

4)12小时制的是小写的h

　　3.获取当前毫秒数:System,currentTimeMillis();

　　4.不允许在程序任何地方中使用

1)java.sql.date

2)java.sql.Time

3)java.sql.Timestamp

　　5.不要在程序中写死一年为365天,避免在公里闰年时出现日期转换错误或程序逻辑错误

1 // 获取今年的天数
2 int daysOfThisYear =LocalDate.now().lengthOfYear();
3 
4 // 获取指定某年的天数
5 LocalDate.of(2011.1.1).lengthOfYear();

　　6.公历闰年2月有29天

六.集合处理

　　1.关于hashCode和equals的处理,遵循如下规则:

1) 只要重写equals,就必须重写hashCode

2)因为set存储的是不重复对象,依据hashCode和equals进行判断,所以set存储的对象必须重写这两个方法

3)如果自定义对象作为Map的件,那么必须覆写hashCode和equals

　　2.判断所有集合内部的元素是否为空,使用isEmpty()方法,而不是size()==0的方式

时间复杂度为O(1);

　　3.在使用java.util.stream.Collectors类的toMap()方法转为Map集合时,一定要使用含有参数类型为BinaryOperator,参数名为mergeFunction的方法,否则当出现相同key值时会抛出lllegalStateException异常

List<Pair<String, Double>> pairArrayList = new ArrayList<>(3);
pairArrayList.add(new Pair<>("version", 6.19));
pairArrayList.add(new Pair<>("version", 10.24));
pairArrayList.add(new Pair<>("version", 13.14));
Map<String, Double> map = pairArrayList.stream().collect(
// 生成的 map 集合中只有一个键值对：{version=13.14}
Collectors.toMap(Pair::getKey, Pair::getValue, (v1, v2) -> v2));