標籤:
?這篇文章主要介紹了eclipse中自動產生javadoc文檔的方法,是實用eclipse開發Java程式時非常實用的技巧,對於進行Java項目開發具有一定的參考借鑒價值,需要的朋友可以參考下
本文執行個體講述了eclipse中自動產生javadoc文檔的方法。分享給大家供大家參考。具體方法如下:
使用eclipse產生文檔(javadoc)主要有三種方法:
1. 在項目列表中按右鍵,選擇Export(匯出),然後在Export(匯出)對話方塊中選擇java下的javadoc,提交到下一步。
在Javadoc Generation對話方塊中有兩個地方要注意的:
javadoc command:應該選擇jdk的bin/javadoc.exe
destination:為產生文檔的儲存路徑,可自由選擇。
按finish(完成)提交即可開始產生文檔。
2. 用菜單選擇:File->Export(檔案->匯出),
剩下的步驟和第一種方法是一樣的。
3. 選中要產生文檔的項目,然後用菜單選擇,
Project->Generate Javadoc直接進入Javadoc Generation對話方塊,剩餘的步驟就和第一種方法在Javadoc Generation對話方塊開始是一樣的。
用哪種方法都行,但是要注意一下幾個問題:
1、eclipse不能產生,報錯:
java.lang.IllegalArgumentException at sun.net.www.ParseUtil.decode
,這是由於設定java環境變數引起的。例如classpath為
.;%JAVA_HOME\lib\dt.jar;%JAVA_HOME%\lib\tool.jar,解決方案就是把classpath刪除或是參考官方文檔 http://maven.apache.org/plugins/maven-javadoc-plugin/faq.html 。
2、產生文檔亂碼問題。完善api-doc,用eclipse產生javadoc的時候發生“編碼 GBK 的不可映射字元 ”其實是字元編碼問題。開啟eclipse,project -> Generate javadoc 一項一項的選你要輸出javadoc的項目,最後一步中VM設定行中加入以下代碼
-encoding utf-8 -charset utf-8
eclipse中自動產生javadoc文檔的方法