この記事の例では、Eclipse で javadoc ドキュメントを自動生成する方法について説明します。皆さんの参考に共有してください。具体的な方法は以下の通りです。
Eclipse を使用してドキュメント (javadoc) を生成するには、主に 3 つの方法があります。
1. プロジェクト リストを右クリックして [エクスポート] を選択し、[エクスポート] ダイアログ ボックスの [java] の下にある [javadoc] を選択して、次の手順に進みます。
「Javadoc 生成」ダイアログ・ボックスには、注意すべき箇所が 2 つあります。
javadocコマンド: jdkのbin/javadoc.exeを選択する必要があります
destination: は生成されたドキュメントの保存パスであり、自由に選択できます。
[終了] を押して送信し、ドキュメントの生成を開始します。
2. メニューを使用して次を選択します: [ファイル] -> [エクスポート] ([ファイル] -> [エクスポート])、
残りの手順は最初の方法と同じです。
3. ドキュメントを生成するプロジェクトを選択し、メニューを使用して選択します。
「プロジェクト」→「Javadoc の生成」を選択すると、「Javadoc の生成」ダイアログ・ボックスが直接表示されます。残りの手順は、「Javadoc の生成」ダイアログ・ボックスから始まる最初の方法と同じです。
どの方法でも使用できますが、いくつかの問題に注意する必要があります。
1. Eclipse を生成できず、エラーが報告されます。
sun.net.www.ParseUtil.decode での java.lang.IllegalArgumentException
これは、Java 環境変数の設定が原因で発生します。たとえば、クラスパスは次のとおりです。
.;%JAVA_HOME/lib/dt.jar;%JAVA_HOME%/lib/tool.jar 解決策は、クラスパスを削除するか、公式ドキュメント http://maven.apache.org/plugins/maven-javadoc- を参照することです。プラグイン/faq.html。
2. 生成されたドキュメントが文字化けします。 api-doc を改善します。Eclipse を使用して Javadoc を生成すると、「マップできない文字エンコーディング GBK」が発生します。これは実際には文字エンコーディングの問題です。 Eclipse を開き、プロジェクト -> javadoc を生成し、javadoc を出力するプロジェクトを 1 つずつ選択します。最後のステップで、次のコードを VM 設定行に追加します: -encoding utf-8 -charset utf。 -8
この記事が皆さんの Java プログラミングに役立つことを願っています。