Java开发规范总结(2)

1.成员变量、类静态变量采用文档注释,对成员变量的注释通常包括:
        1)变量的意义
        2)变量的合法值域
        3)对并发访问的限制
         如:

/** * Web.xml文件中configServlet参数的UIAPP.xml initparam */ public final static String APP_CONFIG = "aaa.uiapp";

2.局部变量,如算法相关的变量采用块或行注释

public void func() { int i; //用于循环计数 ………… }

3.参数变量注释一般用文档注释,并且用@param来说明为参数,一般包括

1) 参数的用途

2) 对参数值范围的要求

4.方法注释

描述函数的功能,对成员方法,静态方法一般采用文档描述,特别是公开的方法。注释可以很详细,为了可读性强也可包含格式控制,如下面说明含有缩进:

/** * Here is a method comment with some very special * formatting that I want indent(1) to ignore.* */

方法注释一般包括:
        1.方法的主要说明,以。或.结束
        2.描述方法完成什么样的功能,方法的目标,用该方法的原因
        3.描述方法的使用方法,包括使用的环境要求,如前置条件,后置条件和并发性要求
        4.描述已知的bug
        5.描述方法的修改历史:<Strong>修改人+日期+简单说明</Strong> (<修改人+日期+简单说明>)
        6.@param c elements to be inserted into this list.(参数说明)
        7.@return <tt>true</tt> if this list changed as a result of the call.(返回值说明)
        8.@throws NullPointerException if the specified Collection is null.(异常说明)
        9.@see如果重载方法必须参考父类的方法
       10Eclips下采用Alt+Shift+J生成Javadoc说明方法的放回值((@return)

5.修改记录

1.在修改一个类前,必须先从SVN中update,之后再进行修改;
    2.修改的地方必须加入注释,说明修改人,修改原因,修改内容,修改时间; 

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/5468ec9705543c77d7bd4965cbafea46.html