Java 文档注释
来源:互联网 发布:济南浪潮数据 编辑:程序博客网 时间:2024/06/08 16:52
Java 文档注释
Java 只是三种注释方式。前两种分别是 // 和 /* */,第三种被称作说明注释,它以 /** 开始,以 */结束。
说明注释允许你在程序中嵌入关于程序的信息。你可以使用 javadoc 工具软件来生成信息,并输出到HTML文件中。
说明注释,使你更加方面的记录你的程序的信息。
javadoc 标签
javadoc 工具软件识别以下标签:
文档注释
在开始的 /** 之后,第一行或几行是关于类、变量和方法的主要描述。
之后,你可以包含一个或多个何种各样的 @ 标签。每一个 @ 标签必须在一个新行的开始或者在一行的开始紧跟星号(*).
多个相同类型的标签应该放成一组。例如,如果你有三个 @see 标签,可以将它们一个接一个的放在一起。
下面是一个类的说明注释的实例:
/*** 这个类绘制一个条形图* @author runoob* @version1.2*/
javadoc 输出什么
javadoc 工具将你 Java 程序的源代码作为输入,输出一些包含你程序注释的HTML文件。
每一个类的信息将在独自的HTML文件里。javadoc 也可以输出继承的树形结构和索引。
由于 javadoc 的实现不同,工作也可能不同,你需要检查你的 Java 开发系统的版本等细节,选择合适的 Javadoc 版本。
实例
下面是一个使用说明注释的简单实例。注意每一个注释都在它描述的项目的前面。
在经过 javadoc 处理之后,SquareNum 类的注释将在 SquareNum.html 中找到。
SquareNum.java 文件代码:
importjava.io.*;/*** 这个类演示了文档注释* @author Ayan Amhed* @version1.2*/publicclassSquareNum{/** * This method returns the square of num. * This is a multiline description. You can use * as many lines as you like. * @paramnum The value to be squared. * @returnnum squared.*/publicdoublesquare(doublenum){returnnum *num;}/** * This method inputs a number from the user. * @return The value input as a double. * @exceptionIOException On input error. * @seeIOException*/publicdoublegetNumber()throwsIOException{InputStreamReaderisr =newInputStreamReader(System.in);BufferedReaderinData =newBufferedReader(isr);Stringstr;str =inData.readLine();return(newDouble(str)).doubleValue();}/** * This method demonstrates square(). * @param args Unused. * @returnNothing. * @exceptionIOException On input error. * @seeIOException*/publicstaticvoidmain(Stringargs[])throwsIOException{SquareNumob =newSquareNum();doubleval;System.out.println("Enter value to be squared: ");val =ob.getNumber();val =ob.square(val);System.out.println("Squared value is " +val);}}
如下,使用 javadoc 工具处理 SquareNum.java 文件:
$ javadoc SquareNum.javaLoading source file SquareNum.java...Constructing Javadoc information...Standard Doclet version 1.5.0_13Building tree for all the packages and classes...Generating SquareNum.html...SquareNum.java:39: warning - @return tag cannot be used\ in method with void return type.Generating package-frame.html...Generating package-summary.html...Generating package-tree.html...Generating constant-values.html...Building index for all the packages and classes...Generating overview-tree.html...Generating index-all.html...Generating deprecated-list.html...Building index for all classes...Generating allclasses-frame.html...Generating allclasses-noframe.html...Generating index.html...Generating help-doc.html...Generating stylesheet.css...1 warning$
0 0
- Java注释及文档注释
- JAVA 文档注释--JAVADOC文档
- JAVA 文档注释
- java文档注释
- java文档注释
- Java文档注释说明
- java注释文档
- Java文档注释方法
- Java 文档注释
- java文档注释
- Java文档注释摘要
- java注释文档
- JAVA文档注释小结
- java文档注释
- Java文档注释
- 番外篇 Java文档注释
- java文档注释详解
- Java文档注释
- 机器学习-实战-入门-MNIST手写数字识别
- WIN32窗口类风格和窗口风格(备查询)
- SuperTextView-从未如此惊艳!一个超级的TextView
- Ubuntu17.04安装Firefox的flash插件
- IntelliJ IDEA下的使用git
- Java 文档注释
- Redis与Memcached的区别
- ThinkPHP中的字段计算
- golang学习笔记
- 安装tensorflow1.0
- 2016年最流行的移动Web前端框架
- 【笔记】哈希
- 图片加载比较好的两种方式
- android基础学习4————Activity的存活