47.2. Javadoc オプション
概要 リンクのコピーリンクがクリップボードにコピーされました!
Java API のメタデータが Javadoc によって提供されている場合、通常はオプションなしで fromJavadoc 要素を指定すれば十分です。ただし、API マッピングに Java API 全体を含めたくない場合は、Javadoc メタデータをフィルタリングして内容をカスタマイズできます。言い換えると、API コンポーネント Maven プラグインは Javadoc メタデータを反復処理することで API マッピングを生成するため、Javadoc メタデータの不要な部分をフィルタリングすることで、生成される API マッピングのスコープをカスタマイズすることができます。
構文 リンクのコピーリンクがクリップボードにコピーされました!
fromJavadoc 要素には、以下のようにオプションの子要素を設定できます。
Scope リンクのコピーリンクがクリップボードにコピーされました!
以下の抜粋で示されているように、fromJavadoc 要素は、任意で apis 要素の子や api 要素の子として表示できます。
以下のスコープで fromJavadoc 要素を定義できます。
-
api要素の子として:fromJavadocオプションは、api要素で指定された API クラスにのみ適用されます。 -
apis要素の子として:fromJavadocオプションは、デフォルトですべての API クラスに適用されますが、apiレベルで上書きできます。
オプション リンクのコピーリンクがクリップボードにコピーされました!
以下のオプションは、fromJavadoc の子要素として定義できます。
excludePackages-
API マッピングモデルから Java パッケージを除外するための正規表現 (
java.util.regex構文) を指定します。正規表現に一致するパッケージ名はすべて除外され、除外されたクラスから派生したすべてのクラスも無視されます。デフォルト値はjavax?\.lang.\*です。 excludeClasses-
API マッピングから API ベースクラスを除外するための正規表現 (
java.util.regex構文) を指定します。正規表現に一致するクラス名はすべて除外され、除外されたクラスから派生するすべてのクラスも無視されます。 excludeMethods-
API マッピングモデルからメソッドを除外するための正規表現 (
java.util.regex構文) を指定します。 includeMethods-
API マッピングモデルのメソッドを含むための正規表現 (
java.util.regex構文) を指定します。 includeStaticMethods-
trueの場合、static メソッドも API マッピングモデルに含まれます。デフォルトはfalseです。