Java 文档注释
来源:互联网 发布:医疗大数据是什么意思 编辑:程序博客网 时间:2024/05/22 09:00
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.*;/*** 这个类演示了文档注释* @authorAyan 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. * @returnThe 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(). * @paramargs 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文档注释
- [FAQ20103][Network]插入移动卡和非移动卡,非移动卡为主卡时无信号
- JetBrains 产品注册
- centos7 代理 镜像 防火墙设置
- mysql习题附带答案以及代码
- linux reboot,卡在“restarting system”
- Java 文档注释
- C#项目将dll打包进exe中
- 微服务架构下处理分布式事务,你必须知道的事儿
- 转载:如何给公司取英文名字
- Socket编程
- 正向代理与反向代理【总结】
- 在边缘实现自主工作负载管理要考虑什么?
- 容器编排工具哪个好?Kubernetes和Swarm深度对比
- 我的第一次编程