java 注释之文档标签
@see :引用其他类
@see标签允许用户引用其他类的文档。javadoc会在其生成的HTML文件中,通过@see标签链接到其他的文档,格式如下
@see classname
@see fully-qualified-classname
@see fully-qualified-classname#method-name
上述每种格式都会在生成的文档中加入一个具有超链接的"See Also"(参见)条目。但是javadoc不会检查你所提供的超链接是否有效。
@link package.class#number label
该标签与@see极其相似,只是它用于行内,并且是用"label"作为超链接文本而不用"See Also"。
@docRoot
该标签产生到文档根目录的相对路径,用于文档树页面的显示超链接
@inheritDoc
该标签从当前这个类的最直接的基类中继承相关文档到当前的文档注释中
@version
该标签的格式如下:
@version version-information
其中" version-information"可以是任何你认为适合包含在版本中说明的重要信息。如果javadoc命令行使用了"-version"标记,那么就从生成的HTML文档中特别提取出版本信息。
@author
该标签的格式如下:
@author author-information
其中,author-information一看便知是你的姓名,但是也可以包括电子邮件地址或者其他任何适宜的信息。如果javadoc命令行使用了-author标记,那么就会从生成的HTML文档中特别提取作者的信息
可以使用多个标签,以便列出所有作者,但是它必须连续放置。全部作者的信息会合并到同一段落,置于生成的HTML中。
@since
该标签允许你指定程序代码最早使用的版本,可以在HTML Java文档中看到它被用来指定所用的JDK版本的情况。
@param
该标签用于方法文档中,形式如下:
@param parameter-name description
其中parameter-name是方法的参数列表中的标识符,description是可延续数行的文本,终止于新的文档标签出现之前。可以使用任意多个这种标签,大约每个参数都有一个这样的标签。
@return
该标签用于方法文档,格式如下:
@return description
其中"description"用来描述返回值的含义,可以延续数行
@throws
由某个方法调用失败而抛出的对象,尽管在调用一个方法时,只出现一个异常对象,但是某个特殊的方法可能会产生任意多个不同类型的异常,所有这些异常都需要进行说明。所以,异常标签的格式如下:
@throws fully-qualified-class-name description
其中fully-qualified-class-name给出一个异常类的无歧义的名字,而该异常类在别处定义。description(同样可以延续数行)告诉你为什么此特殊类型的异常会在方法中调用出现。
@deprecated
该标签用于指出一些旧特性已由改进的新特性所取代,建议用户不要再使用这些旧特性,因为在不久的将来它们很可能会被删除。如果使用一个标记为@deprecated的方法,则会引起编译期发布警告。
在Java SE5中,javadoc标签@deprecated已经被@Deprecated注解所替代
package com.xm.unit01;
/**
* @author mgj
* @version 1.0
*/
public class Hello {
/**
* @param args array of string arguments
* @throws exceptions No exceptions thrown
*/
public static void main(String[] args) {
System.out.println("Hello world!");
}
}