Arch-04-03-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;
注释结构 :
/*
* @(#){ 类名称 }.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 {}
注释结构 :
/**
* 类 <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[];
注释结构 :
/** { 此值是用来存储 / 记录什么的 }*/
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);
}
注释结构 :
?? /**
???? * { 方法的功能 / 动作描述 }
???? *
???? * @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);
}