JAVA入坑之JAVADOC（Java API 文档生成器）与快速生成

以你之姓@ 2024-04-17 11:43 46阅读 0赞

**目录**

一、JAVADOC（Java API 文档生成器）

1.1概述

1.2Javadoc标签

1.3Javadoc命令

1.4用idea自带工具生成API帮助文档

二、IDEA如何生成get和set方法

三、常见快捷方式

3.1快速生成main函数

3.2快速生成println()语句

3.3快速生成for循环

3.4“ifn”：快速生成if(null)语句

3.5Ctrl + /：注释或取消当前行

3.6注释

--------------------

## 一、JAVADOC（Java API 文档生成器） ##

### 1.1概述 ###

> Javadoc是Java SE中的一个工具，文档注释以`/**`开头，并以`*/`结束，可以通过 Javadoc 生成一个和源代码配套的 API 帮助文档，Java 帮助文档主要用来说明类、成员变量和方法的功能。  
>   
> 文档注释只放在类、接口、成员变量、方法之前，因为 Javadoc 只处理这些地方的文档注释，而忽略其它地方的文档注释。

### 1.2Javadoc标签 ###

> Javadoc工具可以识别文档注释中的一些特殊标签，这些标签一般以@开头，后跟一个指定的名字，有的也以\{@开头，以\}结束
> 
> Javadoc标签必须从一行的开头开始，否则将被视为普通文本。一般具有相同名称的标签放在一起。Javadoc标签区分大小写，代码中对于大小写错误的标签不会发生编译错误，但是在生成API帮助文档时会检测不到该注释内容。3

<table> 
 <tbody> 
  <tr> 
   <th>标签</th> 
   <th>描述</th> 
   <th>示例</th> 
  </tr> 
  <tr> 
   <td>@author</td> 
   <td>标识一个类的作者，一般用于类注释</td> 
   <td>@author description</td> 
  </tr> 
  <tr> 
   <td>@deprecated</td> 
   <td>指名一个过期的类或成员，表明该类或方法不建议使用</td> 
   <td>@deprecated description</td> 
  </tr> 
  <tr> 
   <td>{@docRoot}</td> 
   <td>指明当前文档根目录的路径</td> 
   <td>Directory Path</td> 
  </tr> 
  <tr> 
   <td>@exception</td> 
   <td>可能抛出异常的说明，一般用于方法注释</td> 
   <td>@exception exception-name explanation</td> 
  </tr> 
  <tr> 
   <td>{@inheritDoc}</td> 
   <td>从直接父类继承的注释</td> 
   <td>Inherits a comment from the immediate surperclass.</td> 
  </tr> 
  <tr> 
   <td>{@link}</td> 
   <td>插入一个到另一个主题的链接</td> 
   <td>{@link name text}</td> 
  </tr> 
  <tr> 
   <td>{@linkplain}</td> 
   <td>插入一个到另一个主题的链接，但是该链接显示纯文本字体</td> 
   <td>Inserts an in-line link to another topic.</td> 
  </tr> 
  <tr> 
   <td>@param</td> 
   <td>说明一个方法的参数，一般用于方法注释</td> 
   <td>@param parameter-name explanation</td> 
  </tr> 
  <tr> 
   <td>@return</td> 
   <td>说明返回值类型，一般用于方法注释，不能出现再构造方法中</td> 
   <td>@return explanation</td> 
  </tr> 
  <tr> 
   <td>@see</td> 
   <td>指定一个到另一个主题的链接</td> 
   <td>@see anchor</td> 
  </tr> 
  <tr> 
   <td>@serial</td> 
   <td>说明一个序列化属性</td> 
   <td>@serial description</td> 
  </tr> 
  <tr> 
   <td>@serialData</td> 
   <td>说明通过 writeObject() 和&nbsp;writeExternal() 方法写的数据</td> 
   <td>@serialData description</td> 
  </tr> 
  <tr> 
   <td>@serialField</td> 
   <td>说明一个 ObjectStreamField 组件</td> 
   <td>@serialField name type description</td> 
  </tr> 
  <tr> 
   <td>@since</td> 
   <td>说明从哪个版本起开始有了这个函数</td> 
   <td>@since release</td> 
  </tr> 
  <tr> 
   <td>@throws</td> 
   <td>和 @exception 标签一样.</td> 
   <td>The @throws tag has the same meaning as the @exception tag.</td> 
  </tr> 
  <tr> 
   <td>{@value}</td> 
   <td>显示常量的值，该常量必须是 static 属性。</td> 
   <td>Displays the value of a constant, which must be a static field.</td> 
  </tr> 
  <tr> 
   <td>@version</td> 
   <td>指定类的版本，一般用于类注释</td> 
   <td>@version info</td> 
  </tr> 
 </tbody> 
</table>

> 对两种标签格式的说明：
> 
>  *  @tag 格式的标签（不被`{ }`包围的标签）为块标签，只能在主要描述（类注释中对该类的详细说明为主要描述）后面的标签部分（如果块标签放在主要描述的前面，则生成 API 帮助文档时会检测不到主要描述）。
>  *  \{@tag\} 格式的标签（由`{ }`包围的标签）为内联标签，可以放在主要描述中的任何位置或块标签的注释中。

### 1.3Javadoc命令 ###

> javadoc命令是用来生成自己API文档的，使用方式：使用命令行在目标文件所在目录输入javadoc +文件名.java

Javadoc 用法格式如下：

javadoc [options] [packagenames] [sourcefiles]

对格式的说明：

*  options 表示 Javadoc 命令的选项；
 *  packagenames 表示包名；
 *  sourcefiles 表示源文件名。

在 cmd（命令提示符）中输入`javadoc -help`就可以看到 Javadoc 的用法和选项（前提是安装配置了JDK），下面列举 Javadoc 命令的常用选项：

<table> 
 <tbody> 
  <tr> 
   <th>名称</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td> <p>-public</p> <p></p> <p></p> </td> 
   <td>仅显示 public 类和成员</td> 
  </tr> 
  <tr> 
   <td>-protected</td> 
   <td>显示 protected/public 类和成员（默认值）</td> 
  </tr> 
  <tr> 
   <td>-package</td> 
   <td>显示 package/protected/public 类和成员</td> 
  </tr> 
  <tr> 
   <td>-private</td> 
   <td>显示所有类和成员</td> 
  </tr> 
  <tr> 
   <td>-d &lt;directory&gt;</td> 
   <td>输出文件的目标目录</td> 
  </tr> 
  <tr> 
   <td>-version</td> 
   <td>包含 @version 段</td> 
  </tr> 
  <tr> 
   <td>-author</td> 
   <td>包含 @author 段</td> 
  </tr> 
  <tr> 
   <td>-splitindex</td> 
   <td>将索引分为每个字母对应一个文件</td> 
  </tr> 
  <tr> 
   <td>-windowtitle &lt;text&gt;</td> 
   <td>文档的浏览器窗口标题</td> 
  </tr> 
 </tbody> 
</table>

### 1.4用idea自带工具生成API帮助文档 ###

**1. 在IDEA中选择工具（Tool）选项卡打开并选择Generate JavaDoc（生成javaDoc）**

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3EyNDUzMzAzOTYx_size_16_color_FFFFFF_t_70]

**2.配置各种参数**

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3EyNDUzMzAzOTYx_size_16_color_FFFFFF_t_70 1]

第一步：选择生成JavaDoc文档的范围，我只对一个源文件生成Doc，所以选择文件。  
第二步：输出目录最好新建一个文件夹，比较有条理和整洁  
第三步：区域设置，决定文档的语言，简体中文就是zh\_CN、繁体(台湾)zh\_tw、繁体(香港)zh-hk、英语(香港)en-hk、英语(美国)en-us、英语(英国)en-gb、英语(全球)en-ww  
第四步：其他命令行参数：如果区域设置为中国，参数一般为  
\-encoding UTF-8 -charset UTF-8 主要意义是为了显示中文不出现乱码  
第五步：设置完成后点击确定即可生成Doc文档

**3.查看生成文档**

打开输出目录，就可看到成功生成，打开 index.html 便能看生成的文档。

![8f57df856a4d4051baedfe4ea2da106d.png][]

## 二、IDEA如何生成get和set方法 ##

可以用快捷键Alt+[Insert][]来实现

![02ba72e1236f47b5b48546542b964e07.png][]

选择我们想要生成的get 和set

选择属性

![7fad52f6696c480ab643bb5a8762a944.png][]

生成代码

![9e0c3453815d4768a251ab6b2b2d4927.png][]

## 三、常见快捷方式 ##

### 3.1快速生成main函数 ###

> "psvm"是IDEA中的一个快捷键，它可以快速生成main函数。

### 3.2快速生成println()语句 ###

> 使用"sout"来快速生成System.out.println()语句
> 
> ![737bc0546e524561822f61ec63830cea.png][]

### 3.3快速生成for循环 ###

> 可以使用"fori"来快速生成for循环
> 
> ![fe8f0c2a9ee745d6948be7508dd04722.png][]

### 3.4“ifn”：快速生成if(null)语句 ###

### 3.5Ctrl + /：注释或取消当前行 ###

### 3.6注释 ###

> 1.  Ctrl + Shift + /：注释多行
> 2.  Ctrl + Shift + \\：取消多行注释

### 3.7按ctrl加鼠标左键 ###

> 在IntelliJ IDEA中，按下Ctrl键并单击鼠标左键可以跳转到光标所在的符号的定义处。这个快捷键可以用于查看方法、类、变量等的定义。

### 3.8复制当前行并将其插入到下一行 ###

> 在IntelliJ IDEA中，按下Ctrl + D可以复制当前行并将其插入到下一行。如果没有选中任何文本，那么复制整个当前行。如果选中了一些文本，那么复制选中的文本并将其插入到下一行。这个快捷键可以用于快速复制和粘贴代码。

### 3.9Alt + Enter：显示建议的操作列表。 ###

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3EyNDUzMzAzOTYx_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/12/0b86ed6fe66a40cc8e692d3dcb789281.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3EyNDUzMzAzOTYx_size_16_color_FFFFFF_t_70 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/12/d39e06d09f15415785cb99cb479fa52e.png
[8f57df856a4d4051baedfe4ea2da106d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/12/6d458be628de42dfaedf4e379bd25652.png
[Insert]: https://so.csdn.net/so/search?q=Insert&spm=1001.2101.3001.7020
[02ba72e1236f47b5b48546542b964e07.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/12/b7af925506bd4be88a82d69731c24060.png
[7fad52f6696c480ab643bb5a8762a944.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/12/831c217aa31c49d888d1c2392619524a.png
[9e0c3453815d4768a251ab6b2b2d4927.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/12/9d38c797c143420ab33937b109e9b704.png
[737bc0546e524561822f61ec63830cea.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/12/bf1559a63fd14a81bc63d4bf9fd9f7ed.png
[fe8f0c2a9ee745d6948be7508dd04722.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/12/1065b79d9b4e4ff7877fc79249b9887e.png