【代码规范】常见编码规范

文章来源：公众号-智能化IT系统。

1.明确方法功能，精确（而不是近似）地实现方法设计。若是一个功能将在多处实现，即便只有两行代码，也应该编写方法实现。

说明：

虽然为仅用一两行就可完成的功能去编方法好象没有必要，但用方法可以使功能明确化，增长程序可读性，亦可方便维护、测试。

 

2.应明确规定对接口方法参数的合法性检查应由方法的调用者负责仍是由接口方法自己负责，缺省是由方法调用者负责。

说明：

对于模块间接口方法的参数的合法性检查这一问题，每每有两个极端现象，即：要么是调用者和被调用者对参数均不做合法性检查，结果就遗漏了合法性检查这一必要的处理过程，形成问题隐患；要么就是调用者和被调用者均对参数进行合法性检查，这种状况虽不会形成问题，但产生了冗余代码，下降了效率。

 

3.明确类的功能，精确（而不是近似）地实现类的设计。一个类仅实现一组相近的功能。说明：划分类的时候，应该尽可能把逻辑处理、数据和显示分离，实现类功能的单一性。

示例：

数据类不能包含数据处理的逻辑。通讯类不能包含显示处理的逻辑。

 

4.全部的数据类必须重载toString() 方法，返回该类有意义的内容。说明：父类若是实现了比较合理的toString() ， 子类能够继承没必要再重写。

示例：

public TopoNode  {      private String nodeName;      public String toString()       {          return "NodeName : " +  nodeName;       }  }

 

5.数据库操做、IO操做等须要使用结束close()的对象必须在try -catch-finally 的finally中close()。

6.异常捕获后，若是不对该异常进行处理，则应该记录日志（针对后台）。

说明：如有特殊缘由必须用注释加以说明。

7.本身抛出的异常必需要填写详细的描述信息。

说明：便于问题定位。

示例：

throw  new IOException("Writing data error! Data: " + data.toString());

 

8. 在程序中使用异常处理仍是使用错误返回码处理，根据是否有利于程序结构来肯定，而且异常和错误码不该该混合使用，推荐使用异常。说明：一个系统或者模块应该统一规划异常类型和返回码的含义。可是不能用异常来作通常流程处理的方式，不要过多地使用异常，异常的处理效率比条件分支低，并且异常的跳转流程难以预测。

 

9.避免使用不易理解的数字，用有意义的标识来替代。涉及物理状态或者含有物理意义的常量，不该直接使用数字，必须用有意义的静态变量来代替。
示例：

以下的程序可读性差

if  (state == 0) { state = 1; ... // program  code }

应改成以下形式

private final static int  TRUNK_IDLE = 0;  private final static int TRUNK_BUSY = 1;  private final static int TRUNK_UNKNOWN = -1;     if (state == TRUNK_IDLE) {      state = TRUNK_BUSY;      ... // program code }

 

10.数组声明的时候使用 int[] index ，而不要使用 int index[] 。说明：

 

11.异常捕获尽可能不要直接 catch (Exception ex) ，应该把异常细分处理。

12.不要使用难懂的技巧性很高的语句，除非颇有必要时。说明：高技巧语句不等于高效率的程序，实际上程序的效率关键在于算法。

---

公众号-智能化IT系统。每周都有技术文章推送，包括原创技术干货，以及技术工做的心得分享。扫描下方关注。

---

公众号-智能化IT系统。每周都有技术文章推送，包括原创技术干货，以及技术工做的心得分享。扫描下方关注。