常用Java注释标签

1   常用Java注释标签（Java comment tags）
@author  作者适用范围：文件、类、方法
（*多个作者使用多个@author标签标识，java doc中显示按输入时间顺序罗列。）
例：* @author Leo. Yao

@param  输入参数的名称  说明 适用范围：方法
例：* @param str the String用来存放输出信息。

@return 输出参数说明适用范围：方法
例：     * @return    <code>true</code>执行成功;
  *                 <code>false</code>执行失败.

@since JDK版本用于标识编译该文件所需要的JDK环境。
适用范围：文件、类
例：     * @since JDK1.6

@version 版本号用于标识注释对象的版本号
适用范围：文件、类、方法
例：     * @version 1.0

@see 链接目标表示参考。会在java 文档中生成一个超链接，链接到参考的类容。
用法：
@see #field
   @see #Constructor(Type, Type...)
   @see #Constructor(Type id, Type id...)
   @see #method(Type, Type,...)
   @see #method(Type id, Type, id...)
   @see Class
   @see Class#field
   @see Class#Constructor(Type, Type...)
   @see Class#Constructor(Type id, Type id)
   @see Class#method(Type, Type,...)
   @see Class#method(Type id, Type id,...)
   @see package.Class
   @see package.Class#field
   @see package.Class#Constructor(Type, Type...)
   @see package.Class#Constructor(Type id, Type id)
   @see package.Class#method(Type, Type,...)
   @see package.Class#method(Type id, Type, id)
   @see package

@throws 异常标识出方法可能抛出的异常
适用范围：方法
例：     * @throws IOException  If an input or output exception occurred

@deprecated 解释标识对象过期
适用范围：文件、类、方法

@link 链接地址链接到一个目标，用法类似@see。但常放在注释的解释中形如{@link …}
例：
/**
 * @deprecated      As of JDK 1.1, replaced by
 *                         {@link #setBounds(int,int,int,int)}
 */
2 Java注释的使用顺序* @author      (classes and interfaces only, required)
* @version     (classes and interfaces only, required. See footnote 1)
* @param       (methods and constructors only)
* @return      (methods only)
* @exception   (@throws is a synonym added in Javadoc 1.2)
* @see         
* @since       
* @serial      (or @serialField or @serialData)
* @deprecated  (see How and When To Deprecate APIs)