Java学习之文档注释
2017-11-01 18:09
239 查看
前言:关于注释这块,其实用的时候没怎么在意,看了《Java编程思想》这本书看到中间有很详细的讲解了,所以想写个文章记录下。
(2):多行注释。分两种:
以“/”开始,可以跨越多行,最后以“/”结束。
以“/*”开始,可以跨越多行,最后以“/”结束。和第二种相似。这种用于javadoc生成文档。
着重是多行注释的第二种:
作用:避免每次修改代码,都要特地修改文档,所以讲代码和文“档链”接起来。(用到一个工具提取注释:javadoc)
(1)所有的javadoc命令都只能在“/**”注释中出现.
(2)javadoc只能为public(公共)和protected(受保护)成员进行文档注释。
(3)有三种类型的注释文档,分别为:类、属性、方法。类注释位于类定义之前;属性注释位于属性定义之前;方法注释位于方法定义之前。如下列子
javadoc通过生成的HTML文档传送HTML命令,使你能充分利用HTML。主要目的是为了对代码进行格式化。
注意:文档注释中,位于每一行开头的星号和前导空格会被javadoc丢弃。不要在嵌入式HTML中使用标题标签,如<.h1>或<.hr>,因为javadoc会插入自己的标题,这样会和你的标签冲突。所有类型的类、属性、方法注释文档都支持嵌入式HTML。
(2)文档标签
@see:引用其他类的文档
@version:版本
@author:作者信息
@param:方法参数(该标签用于方法文档中)
@return:方法返回值(用于方法文档)
注释类型有2种:
(1):单行注释。以一个”//”起头,直到句末。(2):多行注释。分两种:
以“/”开始,可以跨越多行,最后以“/”结束。
以“/*”开始,可以跨越多行,最后以“/”结束。和第二种相似。这种用于javadoc生成文档。
着重是多行注释的第二种:
作用:避免每次修改代码,都要特地修改文档,所以讲代码和文“档链”接起来。(用到一个工具提取注释:javadoc)
Javadoc
注意:(1)所有的javadoc命令都只能在“/**”注释中出现.
(2)javadoc只能为public(公共)和protected(受保护)成员进行文档注释。
(3)有三种类型的注释文档,分别为:类、属性、方法。类注释位于类定义之前;属性注释位于属性定义之前;方法注释位于方法定义之前。如下列子
/** 类注释 */ public class Demo{ /** 属性注释 */ public int i; /** 方法注释 */ public void f(){} }
使用javadoc方式主要有两种
(1)嵌入式HTMLjavadoc通过生成的HTML文档传送HTML命令,使你能充分利用HTML。主要目的是为了对代码进行格式化。
/** *<pre> *System.out.println(new Date()); *</pre> * */
注意:文档注释中,位于每一行开头的星号和前导空格会被javadoc丢弃。不要在嵌入式HTML中使用标题标签,如<.h1>或<.hr>,因为javadoc会插入自己的标题,这样会和你的标签冲突。所有类型的类、属性、方法注释文档都支持嵌入式HTML。
(2)文档标签
@see:引用其他类的文档
@version:版本
@author:作者信息
@param:方法参数(该标签用于方法文档中)
@return:方法返回值(用于方法文档)
相关文章推荐
- 知识学习——Java文档注释
- Java菜鸟学习笔记(3)--Java API 文档下载与文档注释的使用
- Java学习个人备忘录之文档注释
- java学习09-通过文档注释->生成开发文档
- Java注释和嵌入式文档----学习笔记
- Java 文档&注释 -Java学习笔记(32)
- Java菜鸟学习笔记--配置篇(三):Java API 文档下载与文档注释的使用
- Java 从基础到进阶学习之路---类编写以及文档注释.
- java学习笔记(四)----对象、数组作为参数传递,静态变量、静态方法的使用,内部类,使用文档注释
- Java学习个人备忘录之文档注释
- Java经验点滴:类注释文档编写方法
- Java文档注释说明
- 关于java代码中的注释问题。(类中方法的注释,我们一般都要写上这个方法的文档(doc),方法的参数也要有它的文档)
- JAVA 文档注释--JAVADOC文档
- java类注释文档编写方法
- Java学习之路——使用DOM解析XML文档
- Java学习之路——利用JDOM对xml文档进行解析等操作实例
- 2009-05-27技术学习:Java中对XML文档的操作
- 如何将java程序中的文档注释提取出来生成说明文档
- java文档注释 编写格式