JAVA代码注释规范

最新推荐文章于 2024-09-10 20:52:22 发布

allenlee

最新推荐文章于 2024-09-10 20:52:22 发布

阅读量1.9w

点赞数 3

文章标签： java string character exception class arrays

转载地址

整个类文件注释

示例如下:

Java代码

/*
* @(#)Object.java 1.61 03/01/23
*
* Copyright 2003 Sun Microsystems, Inc. All rights reserved.
* SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*/
package java.lang;

/*

 * @(#)Object.java     1.61 03/01/23

 *

 * Copyright 2003 Sun Microsystems, Inc. All rights reserved.

 * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

 */

 

package java.lang;

注释结构:

/*
* @(#){类名称}.java {创建时间}
*
* {某人或某公司具有完全的版权}
* {使用者必须经过许可}
*/
package java.lang;

/*

 * @(#){类名称}.java       {创建时间}

 *

 * {某人或某公司具有完全的版权}

 * {使用者必须经过许可}

 */

package java.lang;

2. 具体类功能注释

示例如下:

Java代码

/**
* Class <code>Object</code> is the root of the class hierarchy.
* Every class has <code>Object</code> as a superclass. All objects,
* including arrays, implement the methods of this class.
*
* @author unascribed
* @version 1.61, 01/23/03
* @see java.lang.Class
* @since JDK1.0
*/
public class Object {}

/**

 * Class <code>Object</code> is the root of the class hierarchy.

 * Every class has <code>Object</code> as a superclass. All objects,

 * including arrays, implement the methods of this class.

 *

 * @author  unascribed

 * @version 1.61, 01/23/03

 * @see     java.lang.Class

 * @since   JDK1.0

 */

public class Object {}

注释结构:

Java代码

/**
* 类 <code>{类名称}</code>{此类功能描述}
*
* @author {作者}
* @version {版本,常用时间代替}
* @see java.lang.Class
* @since JDK{jdk版本}
*/
public class Object {}

/**

 * 类 <code>{类名称}</code>{此类功能描述}

 *

 * @author  {作者}

 * @version {版本,常用时间代替}

 * @see     java.lang.Class

 * @since   JDK{jdk版本}

 */

public class Object {}

3. 类变量注释

示例如下:

Java代码

/** The value is used for character storage. */
private char value[];

/** The value is used for character storage. */

 private char value[];

注释结构:

Java代码

/** {此值是用来存储/记录什么的}*/
private String str ;

/** {此值是用来存储/记录什么的}*/

 private String str ;

4. 类方法注释

示例如下:

Java代码

/**
* Returns a new string that is a substring of this string. The
* substring begins with the character at the specified index and
* extends to the end of this string. <p>
* Examples:
* <blockquote><pre>
* "unhappy".substring(2) returns "happy"
* "Harbison".substring(3) returns "bison"
* "emptiness".substring(9) returns "" (an empty string)
* </pre></blockquote>
*
* @param beginIndex the beginning index, inclusive.
* @return the specified substring.
* @exception IndexOutOfBoundsException if
* <code>beginIndex</code> is negative or larger than the
* length of this <code>String</code> object.
*/
public String substring(int beginIndex) {
return substring(beginIndex, count);
}

/**

     * Returns a new string that is a substring of this string. The

     * substring begins with the character at the specified index and

     * extends to the end of this string. <p>

     * Examples:

     * <blockquote><pre>

     * "unhappy".substring(2) returns "happy"

     * "Harbison".substring(3) returns "bison"

     * "emptiness".substring(9) returns "" (an empty string)

     * </pre></blockquote>

     *

     * @param      beginIndex   the beginning index, inclusive.

     * @return     the specified substring.

     * @exception  IndexOutOfBoundsException  if

     *             <code>beginIndex</code> is negative or larger than the

     *             length of this <code>String</code> object.

     */

public String substring(int beginIndex) {

return substring(beginIndex, count);

}

注释结构:

Java代码

/**
* {方法的功能/动作描述}
*
* @param {引入参数名} {引入参数说明}
* @return {返回参数名} {返回参数说明}
* @exception {说明在某情况下,将发生什么异常}
*/
public String substring(int beginIndex) {
return substring(beginIndex, count);
}

/**

     * {方法的功能/动作描述}

     *

     * @param      {引入参数名}   {引入参数说明}

     * @return      {返回参数名}   {返回参数说明}

     * @exception   {说明在某情况下,将发生什么异常}

     */

public String substring(int beginIndex) {

return substring(beginIndex, count);

}

5. 类方法中代码块注释

示例如下:

Java代码

/*
* 调用持久化类，将数据保存到库
*
* 判断是添加，还是修改
*/
boolean ifSucc = false;
if(request.getParameter("YINGLI_ID")==null){
String GUID = new RandomGUID().toString();
stressTestDataBean.setUSER_ID(Integer.toString(userId));
stressTestDataBean.setSIGN_ISBN((String)vSectNum.get(0));
stressTestDataBean.setSHENHE_JIEGUO("0");
stressTestDataBean.setGUID(GUID);
stressTestDataBean.setCREATE_DATE("getdate()");
stressTestDataBean.setSTATE("A");
ifSucc = StressTestDataDao.addStressTestData(db,stressTestDataBean);
}else{
ifSucc = StressTestDataDao.mendStressTestData(db,stressTestDataBean);
}

/*

* 调用持久化类，将数据保存到库

*

* 判断是添加，还是修改

*/

boolean ifSucc = false;

if(request.getParameter("YINGLI_ID")==null){

       String GUID = new RandomGUID().toString();

       stressTestDataBean.setUSER_ID(Integer.toString(userId));

       stressTestDataBean.setSIGN_ISBN((String)vSectNum.get(0));

       stressTestDataBean.setSHENHE_JIEGUO("0");

       stressTestDataBean.setGUID(GUID);

       stressTestDataBean.setCREATE_DATE("getdate()");

       stressTestDataBean.setSTATE("A");

                                         

       ifSucc = StressTestDataDao.addStressTestData(db,stressTestDataBean);

}else{

       ifSucc = StressTestDataDao.mendStressTestData(db,stressTestDataBean);

}

注释结构:

Java代码