-
- 既知のすべての実装クラス:
StandardDoclet
public interface Doclet
ユーザー・ドックレットは、「パッケージの説明」で説明されているように、このインタフェースを実装する必要があります。 ドックレットの各実装は、ドックレットをインスタンス化するためにツールによって使用されるパブリック引数なしのコンストラクタを提供する必要があります。 ツール・インフラストラクチャとこのインタフェースを実装したクラスとの相互作用は、次のようになります。- このツールは、ドックレット・クラスの引数なしのコンストラクタを使用してドックレットのインスタンスを作成します。
- 次に、適切なロケールとレポータを使用して
init
メソッドを呼び出します。 - その後、ツールは
getSupportedOptions
とgetSupportedSourceVersion
を呼び出します。 これらのメソッドは一度だけ呼び出されます。 - 必要に応じて、このツールはドックレット・オブジェクトの
run
メソッドを呼び出し、ドックレットがドキュメントに含める要素を決定できるDocletEnvironmentオブジェクトを与えます。
上記のプロトコルを守らずにドックレット・オブジェクトを作成して使用すると、ドックレットの動作はこのインタフェース仕様では定義されません。
ドックレットを開始するには、
-doclet
の後に、javadocツールのコマンドラインでエントリ・ポイント・クラス(すなわち、このインタフェースの実装)の完全修飾名を渡します。- 導入されたバージョン:
- 9
-
-
ネストされたクラスのサマリー
ネストされたクラス 修飾子と型 インタフェース 説明 static interface
Doclet.Option
Docletが使用するオプション名、別名、パラメータ、および記述のカプセル化。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 String
getName()
ドックレットを識別する名前を返します。Set<? extends Doclet.Option>
getSupportedOptions()
サポートされているすべてのオプションを返します。SourceVersion
getSupportedSourceVersion()
このドックレットでサポートされているJavaプログラミング言語のバージョンを返します。void
init(Locale locale, Reporter reporter)
指定されたロケールとエラー・レポータでこのドックレットを初期化します。boolean
run(DocletEnvironment environment)
ドックレットのエントリ・ポイント。
-
-
-
メソッドの詳細
-
init
void init(Locale locale, Reporter reporter)
指定されたロケールとエラー・レポータでこのドックレットを初期化します。 このロケールは、レポータとドックレットのコンポーネントで使用されます。- パラメータ:
locale
- 使用されるロケールreporter
- 使用するレポータ
-
getName
String getName()
ドックレットを識別する名前を返します。 名前は、「Java™言語仕様」のセクション6.2 "名前と識別子"で定義されているように、空白のない単純な識別子です。- 戻り値:
- ドックレットの名前
-
getSupportedOptions
Set<? extends Doclet.Option> getSupportedOptions()
サポートされているすべてのオプションを返します。- 戻り値:
- サポートされているすべてのオプションを含むセット、存在しない場合は空のセット
-
getSupportedSourceVersion
SourceVersion getSupportedSourceVersion()
このドックレットでサポートされているJavaプログラミング言語のバージョンを返します。- 戻り値:
- このドックレットでサポートされている言語バージョン、通常は最新バージョン
-
run
boolean run(DocletEnvironment environment)
ドックレットのエントリ・ポイント。 さらなる処理は、このメソッドによって指示されるように開始します。- パラメータ:
environment
- そこから本質的な情報を抽出することができる- 戻り値:
- 成功した場合はtrue
-
-