java 代码规范

内容导读

互联网集市收集整理的这篇技术教程文章主要介绍了java 代码规范，小编现在分享给大家，供广大互联网技能从业者学习和参考。文章包含3580字，纯文字阅读大概需要6分钟。

内容图文

java 代码规范

参考

• google 的 java 规范
• 阿里 java 开发手册

源文件组织结构

• 源文件必须按顺序由以下部分组成：
  • 许可证（License）或版权声明（Copyright）
  • package语句
    • package语句占据单独一行不换行，允许超出120字符列宽限制。
  • import语句
    • 非static imports，禁止使用通配符import。
    • 所有未使用的import语句应该被删除。
  • 唯一的顶层类
    • 每个源文件只允许包含唯一一个顶层类。
    • 重载的方法必须放在一起，即同名的构造函数或方法之间禁止插入其他成员。
  • 每两部分之间用一个空行分隔，不允许多个空行。

代码格式

• 每行只写一条语句, 每条语句之后都要换行。
• 在类的不同的成员间增加空行，包括：成员变量、构造函数、方法、内部类、静态初始化块、实例初始化块等.
• 两个成员变量声明之间可以不加空行。空行通常用于对成员变量进行逻辑分组。
• 方法体内，按需增加空行，以便从逻辑上对语句进行分组
• 除行首缩进、注释和字符串内的空格以外，禁止使用连续的空格
• 类型与中括号紧挨相连来 表示 数组。用String[] args的方式来声明数组，而非String args[]。
• 添加在类、方法、构造函数、成员属性上的注解（Annotation）直接写在注释块之后，每个注解独占一行。
• 当同时使用多个修饰符时，按照下列顺序：
  • public protected private abstract static final transient volatile synchronized native strictfp
• 长整型数字必须使用大写字母L结尾，不能使用小写字母l，以便和数字1进行区分。例如使用3000000000L而不是3000000000l

命名

• 通常有多种方式将短语组织成驼峰方式，像一些缩写词：IPv6、iOS等。为了统一，必须遵循以下几点规则。
  • 将字符全部转换为ASCII字符，并且去掉’等符号。例如，Müller's algorithm被转换为Muellers algorithm
  • 在空格和标点符号处对上一步的结果进行切分，组成一个词组。

编程实践

• 关于基本数据类型与包装数据类型的使用标准如下：
  • 所有的 POJO 类（普通定义的类）属性必须使用包装数据类型。
  • RPC 方法的返回值和参数必须使用包装数据类型。
  • 所有的局部变量使用基本数据类型。
• 避免通过一个类的对象引用访问此类的静态变量或静态方法，无谓增加编译器解析成本，直接用类名来访问即可。
• 所有的覆写方法，必须加@Override 注解。
• 相同参数类型，相同业务含义，才可以使用 Java 的可变参数，避免使用 Object。
• 不能使用过时的类或方法。
• Object 的 equals 方法容易抛空指针异常，应使用常量或确定有值的对象来调用 equals。
• 所有的相同类型的包装类对象之间值的比较，全部使用 equals 方法比较。
• 定义 DO/DTO/VO 等 POJO 类时，不要设定任何属性默认值。
  • 阿里巴巴Java开发手册中的DO、DTO、BO、AO、VO、POJO定义
• 构造方法里面禁止加入任何业务逻辑，如果有初始化逻辑，请放在 init 方法中。
• POJO 类必须写 toString 方法。
• 禁止覆盖（Override）Object.finalize方法。
• 关于 hashCode 和 equals 的处理，只要重写 equals，就必须重写 hashCode。
• ArrayList 的 subList 结果不可强转成 ArrayList，否则会抛出 ClassCastException 异常，即 java.util.RandomAccessSubList cannot be cast to java.util.ArrayList。在 subList 场景中，高度注意对原集合元素的增加或删除，均会导致子列表的遍历、 增加、删除产生 ConcurrentModificationException 异常。
• 线程资源必须通过线程池提供，不允许在应用中自行显式创建线程。
• 线程池不允许使用 Executors 去创建，而是通过 ThreadPoolExecutor 的方式，这样的处理方式让写的同学更加明确线程池的运行规则，规避资源耗尽的风险。
• 类、类属性、类方法的注释必须使用 Javadoc 规范，使用/** 内容 **/格式，不得使用 // xxx 方式。
• 异常不要用来做流程控制，条件控制。
• catch 时请分清稳定代码和非稳定代码，稳定代码指的是无论如何不会出错的代码。 对于非稳定代码的 catch 尽可能进行区分异常类型，再做对应的异常处理。
• 捕获异常是为了处理它，不要捕获了却什么都不处理而抛弃之，如果不想处理它，请 将该异常抛给它的调用者。最外层的业务使用者，必须处理异常，将其转化为用户可以理解的内容。
• 有 try 块放到了事务代码中，catch 异常后，如果需要回滚事务，一定要注意手动回 滚事务。
• finally 块必须对资源对象、流对象进行关闭，有异常也要做 try-catch。 说明：如果 JDK7 及以上，可以使用 try-with-resources 方式。
• 不要在 finally 块中使用 return。
• 捕获异常与抛异常，必须是完全匹配，或者捕获异常是抛异常的父类。

内容总结

以上是互联网集市为您收集整理的java 代码规范全部内容，希望文章能够帮你解决java 代码规范所遇到的程序开发问题。 如果觉得互联网集市技术教程内容还不错，欢迎将互联网集市网站推荐给程序员好友。

内容备注

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 gblab@vip.qq.com 举报，一经查实，本站将立刻删除。

内容手机端