Posted on 2008-05-29 12:10
TuringJava 阅读(774)
评论(0) 编辑 收藏 所属分类:
J2SE
整个类文件注释
示例如下:
- /*
-
- * @(#)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);
-
- }