1 Javadoc
javadoc
ツールは、ソース・ファイルのコレクションを内部形式へと読み込むプログラムです。
構造は次のとおりです: (source-files)->[javadoc-tool:doclet]->(generated files)
Javadocのドックレットは接続可能なバック・エンドのようなもので、いくつかの目標を念頭に置いてこの内部フォームを分析します。このドックレットに基づいて、HTML、MIFまたはXMLファイルを生成できます。
生成されたファイルのコンテンツはドックレットに固有です。標準ドックレットはHTMLドキュメントを生成しますが、他のドックレットの中にはスペルミスのある単語や構文エラーのレポートを生成できるものもあります。
標準ドックレット以外のドックレットを指定した場合、そのドックレットや生成されたファイル(ある場合)の操作にはこのガイドの説明が当てはまらない可能性があります。
javadoc
ツールを使用するには、次の条件を満たしている必要があります。
-
ソース・コードを書く際にドキュメント・コメントを含めます。ドキュメント・コメントはHTML形式でフォーマットされ、
javadoc
ツールが組み入れられています。 -
javadoc
ツールを実行します。ドキュメント・コメントおよびその他の特別なタグを分析できるように、ドックレットを指定する必要があります。ただし、ドックレットを指定しない場合は、デフォルトで標準ドックレットが含められます。多数のコマンド行オプションを指定しますが、そのうちのあるものはjavadoc
ツールそのものに適用され、あるものは選択されたドックレットに固有です。コマンド行ヘルプにより、現在選択されているドックレットに適用されるツールのオプションを表示および識別できます。標準ドックレットを使用した場合、標準ドックレットによって生成される出力は一連のHTMLページで構成されます。別のドックレットを指定した場合、そのドックレットの操作およびそれにより生成されるファイル(ある場合)は、このガイドで説明されている標準ドックレットと同じ場合もあればそうでない場合もあります。
Javadocの機能
Javadocの機能には、Javadoc検索、HTML5出力の生成のサポート、モジュール・システム内のドキュメント・コメントのサポート、および簡略化されたドックレットAPIが含まれます。
検索
javadoc
ツールは、出力を生成するドックレットを実行します。標準ドックレットでは出力が生成され、その生成されたドキュメントで検索ができます。生成されたAPIには検索ボックスがあり、次のものが提供されています。
-
APIで定義されている要素や追加のキー・フレーズを検索できます。
-
結果。まず入力された文字に完全に一致する結果、それに続いて、入力された文字が文字列の任意の場所に含まれる結果が表示されます。複数の結果は検索ボックスの下に単純なスクロール・リストとして表示されます。結果は、分類およびユーザー選択がしやすいように次のように分類されます。
-
モジュール
-
パッケージ
-
タイプ
-
メンバー
-
検索タグ
@inheritDoc
タグを使用して継承されている場合、異なるプログラム要素名がある複数の結果が表示されます。 -
-
ユーザー選択に基づくページ・リダイレクション。
次の項目を検索できます。
-
宣言されているモジュール、パッケージ、タイプおよびメンバーの名前: メソッドはオーバーロード可能であるため、メソッドのパラメータ・タイプの単純名も索引付けされ、検索できます。メソッドのパラメータ名はインデックス化されません。
-
新しいインライン・タグ
@index
を使用してインデックス化された検索語または句:@index
内で他のインライン・タグをネストすることはできません。宣言のjavadoc
コメント内の、@index
でマークされた句または検索語のみを検索できます。たとえば、ドメイン固有の語ulps
がjava.lang.Math
クラス全体で使用されているものの、クラスやメソッドの宣言名には出現しないとします。Math APIのユーザーのために、APIデザイナはクラス・レベルのjavadoc
コメントやメソッド・レベルのjavadoc
コメントに各種出現するulps
をタグ付けできます。タグ付けは{@index ulps}
を使用して行います。語ulps
はjavadoc
ツールを使用してインデックス化されます。
モジュール・システム
javadoc
ツールはモジュール宣言内のドキュメンテーション・コメントをサポートしています。一部のJavadocコマンド行オプションでは、ドキュメント化するモジュールのセットを指定し、ドキュメント化されるモジュールの新しいサマリー・ページを生成できます。ドキュメント化されるモジュールのセットを構成し、ドキュメント化されるモジュールの新しいサマリー・ページを生成できる、新しいコマンド行オプションがあります。Java Platform, Standard Editionツール・リファレンスのjavadocの章を参照してください。
HTML 5サポート
HTML5出力を生成できます。HTML5完全準拠の出力を得るためには、ドキュメント・コメント内で提供されるHTMLコンテンツがHTML5準拠となっている必要があります。
簡略化されたドックレットAPI
ドックレットAPIでは、すべての言語機能をよりよく表せるように、強力なAPIを使用します。Javadoc標準ドックレットを参照してください。