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. 具体类功能注释 示例如下: /** * 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 {} 注释结构: /** * 类 <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. 类变量注释 示例如下: /** The value is used for character storage. */ private char value[]; /** The value is used for character storage. */ private char value[]; 注释结构: /** {此值是用来存储/记录什么的}*/ private String str ; /** {此值是用来存储/记录什么的}*/ private String str ; 4. 类方法注释 示例如下: /** * 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); } 注释结构: /** * {方法的功能/动作描述} * * @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.     类方法中代码块注释 示例如下: /* * 调用持久化类，将数据保存到库 * * 判断是添加，还是修改 */ 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); } 注释结构: /* * {功能描述} * * {具体实现动作} */ 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); }