java 注释 超链接_Java注释

注释(commentary )是程序中用于说明和解释的一段文字对程序运行不起作用。程序 中添加注释的目的是增强程序的可读性。

Java提供3种注释方式:。

单行注释://

多行注释/**/

文档注释:

/**

*文档注释用于从源代码自动生成文档执行javadoc

*命名根据源代码中的内容生成网页

*@XXX

*/

不同格式的注释可以嵌套。

// Welcome1.java. Text-printing program.

/*计信学院09软件工程2班

**姓名XXX

**2011年2月26日1800最后修改。*/

public class Welcome1

{

// main method begins execution of application

public static void main( String args[] ){

System.out.println( "梅花香子苦寒来!" );

}

}

文档注释参数说明

@see 生成文档中的“参见xx 的条目”的超链接后边可以加上“类名”、“完整类名”、“完整类名#方法”。可用于类、方法、变量注释。@param 参数的说明。可用于方法注释。@return 返回值的说明。可用于方法注释。@exception 可能抛出异常的说明。可用于方法注释。@version 版本信息。可用于类注释。@author 作者名。可用于类注释。

>javadoc first.java

javadoc命令javadoc [options] [packagenames] [sourcefiles]

-public 仅显示 public 类和成员 -protected 显示 protected/public 类和成员 (缺省)-package 显示 package/protected/public 类和成员-private 显示所有类和成员-d 输出文件的目标目录-version 包含 @version 段-author 包含 @author 段-splitindex 将索引分为每个字母对应一个文件-windowtitle 文档的浏览器窗口标题

Eclipse中JavaDoc的生成方式

在项目列表中选择项目按右键选择Export导出然后在Export(导出)对话框中选择java下的javadoc。

在Javadoc Generation对话框中有两个地方要注意的 1javadoc command:应该选择jdk的bin/javadoc.exe。 2destination:为生成文档的保存路径。