本站提供最佳js插件源码修改服务,欢迎转载和分享。

【开心众筹源码】【黄鱼溯源码】【中信crm源码】程序源码规范_程序源码规范有哪些

2024-12-24 03:24:02 来源:app源码宝塔搭建 分类:焦点

1.java开发规范
2.软著软件源代码应符合什么要求 软著申请源代码格式是程序程序什么
3.psr是什么意思

程序源码规范_程序源码规范有哪些

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。

       4、包名、异常、枚举、方法名称的中信crm源码定义。

       (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、行字符数限制不超过 个,超出需要换行,换行时遵循如下原则:

       (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(“

【本文网址:http://04.net.cn/html/73b353496392.html 欢迎转载】

copyright © 2016 powered by 皮皮网   sitemap