1.java开发规范
2.java小程序源代码,比较简单点的规范,100多行,源源码谁有啊
java开发规范
阅读目录
(一) Java 命名规范
1、变量、较规成员、比较rsa测试源码方法名统一采用驼峰命名 (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。
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、注释规范:注释的tesseract vb源码双斜线与注释内容之间有且仅有一个空格。
如:// 变量作用 boolean switchTree = false;
4、行字符数限制不超过 个,超出需要换行,换行时遵循如下原则:
(1)第二行相对第一行缩进 4 个空格,从第三行开始,不再继续缩进;(2)运算符与下文一起换行;(3)方法调用的点符号与下文一起换行;(4)方法调用中的多个参数需要换行时,在逗号后进行;(5)在括号前不要换行。
例子:StringBuilder sb = new StringBuilder(); // 超过 个字符的情况下,换行缩进 4 个空格,并且方法前的点号一起换行 sb.append(“A”).append(“B”)… .append(“C”)… .append(“D”)… .append(“E”); 错误示例:StringBuilder sb = new StringBuilder(); // 超过个字符的情况下,不要在括号前换行,下面是违反(5)条 sb.append(“A”).append(“B”)…append (“C”); // 参数很多的方法调用可能超过 个字符,逗号后才是换行处,违反(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 = ?在-至之间的赋值,Integer对象是在 IntegerCache.cache 产生,会复用已有对象,这个区间内的Integer值可以直接使用==进行判断,但是这个区间之外的所有数据,都会在堆上产生,并不会复用已有对象,这是一个大坑,推荐使用equals方法进行判断。
6、任何货币金额,均以最小货币单位且整型类型来进行存储。
如:元 ->
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(".0"); BigDecimal b = new BigDecimal(".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)所有的局部变量使用基本数据类型(推荐)。
、使用索引访问用 String 的 split 方法得到的数组时,需做最后一个分隔符后有无内容的检查,否则会有抛 IndexOutOfBoundsException 的风险。
例子:String str = "a,b,c,e,"; String[] ary = str.split(","); // 预期为5,结果是4 System.out.println(ary.length);
(四) Java 注释规范
1、类(抽象类)、类属性、类方法的注释必须使用 Javadoc 规范,使用 /*内容/ 格式,不得使用 // xxx 方式,在工程调用方法时,不进入方法即可悬浮提示方法、参数、返回值的意义,提高阅读效率。
2、所有的类都必须添加创建者和创建日期。
在 idea 中 File→Settings→Editor→File and Code Templates→Files→Class 中的 include 中添加: @author 为 USER@dateUSER@date{ DATE};
3、方法内部单行注释在被注释语句上方另起一行,使用 // 注释。方法内部多行注释使用 /* */ 注释,注意与代码对齐。
4、在类中删除未使用的任何字段、方法、内部类;在方法中删除未使用的任何参数声明与内部变量。
5、谨慎注释掉代码。在上方详细说明,而不是简单地注释掉。如果无用,则删除。
代码被注释掉:
(1)后续会恢复此段代码逻辑。(2)永久不用,假如需要查阅历史代码,登录代码仓库即可。
6、特殊注释标记,请注明标记人与标记时间。注意及时处理这些标记,通过标记扫描,经常清理此类标记。线上故障有时候就是来源于这些标记处的代码。
(1)待办事宜(TODO):(标记人,标记时间,[预计处理时间]) 表示需要实现,但目前还未实现的功能。是一个 Javadoc 的标签,目前的 Javadoc 还没有实现,但已经被广泛使用。只能应用于类,接口和方法(因为它是一个 Javadoc 标签)。(2)错误,不能工作(FIXME):(标记人,标记时间,[预计处理时间])在注释中用FIXME标记某代码是错误的,而且不能工作,需要及时纠正的情况。
(五) Java 控制语句
1、switch括号内的变量类型为 String 并且此变量为外部参数时,必须先进行 null 判断。
原因是:
switch中的参数如果是 null,则不进行语句 string 任何 case。说明:switch中的 case 都需要有 default(强制)。
2、在 if/else/for/while/do 语句中必须使用大括号。
如:if(t1 == t2){ System.out.println(“