Java：API文档；文档注释中的javadoc标记；官方API；自己动手给项目建一个API文档

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

1、什么是API文档

在Java语言中有3种注释

//单行注释 /* 多行注释 */ /** * 文档注释 */

API（应用程序接口）文档就是用javadoc命令提取文档注释生成的，html格式，用浏览器查看。

API文档既然是由文档注释生成的，那么文档注释怎么写呢？

首先，文档注释必须放在类和方法的前面，格式也要准确。

其中，要写清楚类和方法的功能，以及方法传入的形参和返回值具体是什么。

一般来说，只默认提取public和protected修饰的类、接口、方法、成员变量、构造器、内部类的说明。

2、文档注释中的javadoc标记

@author	程序作者	类/接口的文档注释中
@version	程序版本	类/接口的文档注释中
@param	方法参数说明	方法/构造器的文档注释中
@return	方法返回值说明	方法/构造器的文档注释中
@exception、@throws	抛出的异常	方法/构造器的文档注释中