设为首页 加入收藏

TOP

java开发规范(一)
2023-07-25 21:35:00 】 浏览:45
Tags:java

(一)java命名规范

1、变量、成员、方法名统一采用驼峰命名(lowerCamelCase),做到见语知其义

例子:变量——用户数据(userList)、方法——getUserData(int type)等。
说明:正常变量定义使用驼峰命名,特殊的如DTO\VO\DO等除外。

2、类名的定义

(1)普通类名采用大写字母开始;
(2)抽象类采用Abstract或Base开头。 例子:普通类——class
UserModel,抽象类——abstract class AbstractUserDefinition等。

3、常量、类型、接口、子类的定义

(1)常量使用全大写且单词之间用"_“隔开; (2)boolean变量不能使用is开头;
(3)接口尽量不要修饰符、子类紧跟接口追加Impl。
例子:常量——SORT_TYPE,布尔类型——flag,接口——UserService,实现类——UserServiceImpl等。
说明:常量不可组装,需要原子性定义,不能出现"KEY”+SORT_TYPE这种内部出现。

4、包名、异常、枚举、方法名称的定义

(1)包名一律采用小写; (2)异常都采用_Exception结尾; (3)枚举都是以Enum结尾;
(4)方法名称——根据方法内容采用如插入insert-*。
例子:异常——UserException,包名——com.test,枚举——UserEnum,方法名称——insertUser等。

5、领域模型定义规范:主要是以VO\DTO\DO等结尾

例子:用户数据——UserDTO等 ?(1)数据对象:xxxDO,xxx 即为数据表名。
?(2)数据传输对象:xxxDTO,xxx为业务领域相关的名称。 (3)展示对象:xxxVO,xxx一般为网页名称。
?(4)POJO是DO/DTO/BO/VO的统称,禁止命名成xxxPOJO。

(二)代码格式规范

1、括号代码要求

左大括号前不换行、左大括号后换行、右大括号前换行、右大括号后还有else等代码则不换行;表示终止的右大括号后必须换行。
如:

public static void main(String[] args) {
    String name = "test名称";
    if(name.equals("prod")){
        System.out.println("prod 谨慎!");
    }else if(name.equals("test")){
        System.out.println("test 不删服务器就行!");
    }else{
        System.out.println("别砸电脑就行!");
    }
}

2、括号中间的操作变量要有空格,左右括号不出现空格。

如:if(a == b)

3、注释规范:注释的双斜线与注释内容之间有且仅有一个空格

如:
// 变量作用
boolean switchTree = false;

4、行字符数限制不超过120个,超出需要换行,换行时遵循如下原则:

(1)第二行相对第一行缩进 4 个空格,从第三行开始,不再继续缩进; ?
(2)运算符与下文一起换行;
?(3)方法调用的点符号与下文一起换行; ?
(4)方法调用中的多个参数需要换行时,在逗号后进行; ?
(5)在括号前不要换行。 例子:
StringBuilder sb = new StringBuilder(); // 超过 120 个字符的情况下,换行缩进 4 个空格,并且方法前的点号一起换行 sb.append(“A”).append(“B”)…
.append(“C”)…
.append(“D”)…
.append(“E”);
错误示例:
StringBuilder sb = new StringBuilder(); // 超过120个字符的情况下,不要在括号前换行,下面是违反(5)条
sb.append(“A”).append(“B”)…append
(“C”); // 参数很多的方法调用可能超过 120个字符,逗号后才是换行处,违反(3)条
method(s1, s2, s3, …
, argsX);

5、方法传参中,多个参数之间要有空格。

例子:
private static void test1(String name, String user){
System.out.println(“test1”);
}

(三)java程序规范

1、重写方法规范:重写方法必须添加注解@Override避免方法名不一致

2、参数如果相同、含义也相同,使用可变参数替换逐个定义

3、不能使用过时的类或方法

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

如:“test”.equals(key)

5、所有整型包装类对象之间值的比较,使用equals方法比较

原因:对于 Integer var = ?在-128至127之间的赋值,Integer对象是在
IntegerCache.cache产生,会复用已有对象,这个区间内的Integer值可以直接使用==进行判断,但是这个区间之外的所有数据,都会在堆上产生,并不会复用已有对象,这是一个大坑,推荐使用equals方法进行判断。

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

如:10元 ->> 1000

7、浮点数之间的比较

浮点型的包装类的比较不能使用equals,采用BigDecimal来实现,float基本类型不能使用==判定,采用误差范围之内相等。
(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("11.0");
BigDecimal b = new BigDecimal("10.9");
BigDecimal x = a.subtract(b);
if (x.compareTo(y) == 0) {
    System.out.println("true");
}

8、禁止使用构造方法BigDecimal(double)的方式把double值转化为BigDecimal对象

原因:精度会损失。 正确例子:使用BigDecimal bg = BigDecimal.valueOf(double)进行初始化。

9、基本类型和包装类型使用规范

(1)所有的POJO类属性必须使用包装数据类型;
?(2)RPC方法的返回值和参数必须使用包装数据类型;
?(3)所有的局部变量使用基本数据类型(推荐)。

10、使用索引访问用String的split方法得到的数组时,需做最后一个分隔符后有无内容的检查,否则会有抛IndexOutOfBoundsException的风险

例子:

String str = "a,b,
首页 上一页 1 2 下一页 尾页 1/2/2
】【打印繁体】【投稿】【收藏】 【推荐】【举报】【评论】 【关闭】 【返回顶部
上一篇Java运算符 下一篇Spring Security(6)

最新文章

热门文章

Hot 文章

Python

C 语言

C++基础

大数据基础

linux编程基础

C/C++面试题目