1、什麼是API文檔
在Java語言中有3種註釋
//單行註釋
/*
多行註釋
*/
/**
* 文檔註釋
*/
API（應用程序接口）文檔就是用javadoc命令提取文檔註釋生成的，html格式，用瀏覽器查看。
API文檔既然是由文檔註釋生成的，那麼文檔註釋怎麼寫呢？
首先，文檔註釋必須放在類和方法的前面，格式也要準確。
其中，要寫清楚類和方法的功能，以及方法傳入的形參和返回值具體是什麼。
一般來說，只默認提取public和protected修飾的類、接口、方法、成員變量、構造器、內部類的說明。
2、文檔註釋中的javadoc標記
| @author | 程序作者 | 類/接口的文檔註釋中 |
|---|---|---|
| @version | 程序版本 | 類/接口的文檔註釋中 |
| @param | 方法參數說明 | 方法/構造器的文檔註釋中 |
| @return | 方法返回值說明 | 方法/構造器的文檔註釋中 |
| @deprecated | 該標記用於指出一些舊功能已由改進過的新功能取代 | 該標記的作用是建議用戶不 必再使用一種特定的功能，因爲未來改版時可能摒棄這一功能。 |
| @exception、@throws | 拋出的異常 | 方法/構造器的文檔註釋中 |
3、官網下載
打開index.html：
4、自己創建一個API文檔
javadoc -d apidoc -windowtitle 測試 -doctitle JavaSE學習 -header 側欄名字 -author basicGrammar/*.java designPatterns/*.java
- -d ：輸出文件的目標目錄
- -windowtitle ：文檔的瀏覽器窗口標題
- -doctitle ：概覽頁面的標題
- -header ：每個頁面的頁眉文本
- -author：包含 @author 段
- -version：包含 @version 段
