本文實例講述了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設置行中加入以下代碼
希望本文所述對大家的Java程序設計有所幫助。