javadoc的使用

在進行項目開發過程中，項目接口文檔是很重要的一塊內容，在java項目中我們可以用swagger，asciidoc，javadoc等方式來生產文檔，而其中最基本的文檔生成方式就是javadoc，它一般用在離線文檔的生成上，我們需要按排它的規定來書寫注釋，從而最終生成文檔。

標准化注釋

1. @link：{@link 包名.類名#方法名(參數類型)} 用於快速鏈接到相關代碼
2. @code： {@code text} 將文本標記為code
3. @param：一般類中支持泛型時會通過@param來解釋泛型的類型
4. @author：作者信息
5. @see ：另請參閱，其它備注
6. @since ：從以下版本開始
7. @version：當前版本號
8. @param：后面跟參數名，再跟參數描述
9. @return：返回值
10. @throws ：跟異常類型 異常描述 , 用於描述方法內部可能拋出的異常跟返回值的描述
11. @exception：用於描述方法簽名throws對應的異常
12. @see：既可以用來類上也可以用在方法上，表示可以參考的類或者方法
13. @value：用於標注在常量上，{@value} 用於表示常量的值
14. @inheritDoc：用於注解在重寫方法或者子類上，用於繼承父類中的Javadoc

生成doc文件

工具＝生成doc （tools=generate javaDocs...）

• 如果是中文注釋，需要注意幾點

1. locale：設置成zh_CN
2. other command line arguments 設置成-encoding UTF-8 -charset UTF-8