最近回过头来给以前的项目增加功能,发现之前写的注释非常不全,代码也非常的不整洁,有些地方写的‘’窝七八烂的,看着很不舒服;又恰好经理最近也经常跟我提起代码规范,我们就讨论了一下代码规范的重要性和必要性,于是决定我们也要制定个规范,这样利于团队开发,统一代码风格,写出来的代码也不会风格迥异;

最近几天有空就跟其他公司的盆友聊起这件事,越发觉得代码规范的必要性,于是根据其他公司盆友以及自己整理的一些细节制定了一套规范,作为公司团队开发的代码规范。

代码编写一些规范

首先Java实例三大原则:

1、必须实现序列化接口

2、必须有set/get方法

3、必须实现hash()/tostring()方法

普通规范:

4、字段方法命名必须满足驼峰命名规则,类名必须大写

5、文件、类、字段、方法(除了set/get方法)必须有注释

文件注释规范:

/**

 * 文件名:xxx.java

 * 描述:xxx

 * 修改人:xxx

 * 修改时间:20xx年xx月xx日

 * 修改内容:

 */

类注释规范:

/**

 * 〈一句话功能简述〉  

 * 〈功能详细描述〉  

 * @author xxx 

 * @version 20xx年xx月xx日  

 * @see xxx 

 * @since

 */

字段注释规范:

/**

  *意义,目的和功能,以及被用到的地方

  */

方法注释规范:

/**

     * 方法描述

     * @param xxx

     * 参数描述

     * @param xxx

     * 参数描述

     * @return xxx

     */

6、equals()方法使用规范

必须采用字符串比较参数:"xxx".equals(xxx)

7、接收到的方法参数必须判断是否空值

8、字段和字段,方法和方法之间必须空一行

9、每个方法只实现一个功能

10、for循环不超过三层,if()条件判断不能超过三个

11、大括号位置要对称,不能出现大括号在语句后面的情况

if (a > b)

{

a = b;

}

12、关键字,运算符,变量等字段要空格,方便阅读

13、同一行语句不能太长,最长不超过130字符

最新文章

  1. Java正则速成秘籍(二)之心法篇
  2. java-并发-活性
  3. 使用curl进行https请求
  4. python 数据库
  5. ruby on rails 在centos 7下的安装配置
  6. Java基础常见英语词汇
  7. java ReentrantLock可重入锁功能
  8. Python学习笔记——Day4
  9. 【笨嘴拙舌WINDOWS】GDI(1)
  10. openStack 性能开测
  11. Contains Duplicate II ——LeetCode
  12. Delphi HTTP error message: Can't execute C:\Program Files\Borland\Delphi7\Bin\serverinfo.exe 1813
  13. 视频日志之android的总结与思考
  14. 使用GDAL图书馆RPC校正问题
  15. MongoDB聚合管道(Aggregation Pipeline)
  16. 聊一聊JQ中delegate事件委托的好处
  17. OSGi-入门篇之生命周期层(03)
  18. 关于jQuery.click()函数
  19. Facebook-Haystack合并小文件
  20. MQ队列与哪些机器连接

热门文章

  1. Java 设计模式(四)-工厂方法模式 (FactoryMethod Pattern)
  2. 【原创】10万条数据采用存储过程分页实现(Mvc+Dapper+存储过程)
  3. windows和linux双系统修改启动项
  4. [C#学习]1.Hello World
  5. Ubuntu14.04双网卡主备配置
  6. 基于路由器物理接口的vlan间路由
  7. grep与正则表达式
  8. Redis学习-SortedSet
  9. BeanInstantiationException: Failed to instantiate [java.time.LocalDateTime]
  10. Spring-bean作用域scope详解