-
public interface RoundEnvironment
注釈処理ツール・フレームワークは、注釈プロセッサにこのインタフェースを実装したオブジェクトを提供することで、そのプロセッサが、注釈処理のあるラウンドに関する情報の問い合わせを行えるようにします。- 導入されたバージョン:
- 1.6
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド デフォルト・メソッド 修飾子と型 メソッド 説明 boolean
errorRaised()
前回の処理ラウンドでエラーが発生した場合はtrue
を返し、それ以外の場合はfalse
を返します。Set<? extends Element>
getElementsAnnotatedWith(Class<? extends Annotation> a)
指定された注釈型を使って注釈を付けられた要素を返します。Set<? extends Element>
getElementsAnnotatedWith(TypeElement a)
指定された注釈型を使って注釈を付けられた要素を返します。default Set<? extends Element>
getElementsAnnotatedWithAny(Set<Class<? extends Annotation>> annotations)
指定された注釈型の1つ以上で注釈が付けられた要素を返します。default Set<? extends Element>
getElementsAnnotatedWithAny(TypeElement... annotations)
指定された注釈型の1つ以上で注釈が付けられた要素を返します。Set<? extends Element>
getRootElements()
以前のラウンドによって生成された注釈処理の「ルート要素」を返します。boolean
processingOver()
このラウンドで生成された型が後続の注釈処理ラウンドの対象にならない場合はtrue
を返し、それ以外の場合はfalse
を返します。
-
-
-
メソッドの詳細
-
processingOver
boolean processingOver()
このラウンドで生成された型が後続の注釈処理ラウンドの対象にならない場合はtrue
を返し、それ以外の場合はfalse
を返します。- 戻り値:
- このラウンドで生成された型が後続の注釈処理ラウンドの対象にならない場合は
true
、それ以外の場合はfalse
を返します
-
errorRaised
boolean errorRaised()
前回の処理ラウンドでエラーが発生した場合はtrue
を返し、それ以外の場合はfalse
を返します。- 戻り値:
- 前回の処理ラウンドでエラーが発生した場合は
true
、それ以外の場合はfalse
-
getRootElements
Set<? extends Element> getRootElements()
以前のラウンドによって生成された注釈処理の「ルート要素」を返します。- 戻り値:
- 前回のラウンドで生成された注釈処理のルート要素。存在しなかった場合は空のセット
-
getElementsAnnotatedWith
Set<? extends Element> getElementsAnnotatedWith(TypeElement a)
指定された注釈型を使って注釈を付けられた要素を返します。 注釈は、直接使用されていても、継承されていてもかまいません。 この注釈処理ラウンドのパッケージ要素、モジュール要素、および型要素included、またはそれらの中で宣言されたメンバー、コンストラクタ、パラメータ、または型パラメータの宣言のみが返されます。 含まれる型要素は、ルートの型と、それらの内側にネストされたすべてのメンバーの型です。 パッケージの要素は、そのパッケージのpackage-info
ファイルが作成されたために含まれているとはみなされません。 同様に、モジュールの要素は、そのモジュールのmodule-info
ファイルが作成されたために含まれているとはみなされません- パラメータ:
a
- 要求された注釈型- 戻り値:
- 指定された注釈型を使って注釈を付けられた要素。存在しない場合は空のセット
- 例外:
IllegalArgumentException
- 引数が注釈型を表していない場合
-
getElementsAnnotatedWithAny
default Set<? extends Element> getElementsAnnotatedWithAny(TypeElement... annotations)
指定された注釈型の1つ以上で注釈が付けられた要素を返します。- APIの注:
- このメソッドは、注釈型とその注釈型を同時に検索して繰り返し注釈を処理する場合に役立ちます。
- 実装要件:
- このメソッドのデフォルトの実装では、空の結果セットが作成され、各注釈の
getElementsAnnotatedWith(TypeElement)
を呼び出してその結果セットに結果を追加して、引数配列の注釈を反復処理します。 最後に、結果セットの内容は変更不可能なセットとして返されます。 - パラメータ:
annotations
- 注釈型がリクエストされている- 戻り値:
- 指定された注釈型の1つ以上で注釈された要素、または存在しない場合は空のセット
- 例外:
IllegalArgumentException
- 引数セットの任意の要素が注釈型を表さない場合- 導入されたバージョン:
- 9
- Java™言語仕様:
- 9.6.3反復可能な注釈型
-
getElementsAnnotatedWith
Set<? extends Element> getElementsAnnotatedWith(Class<? extends Annotation> a)
指定された注釈型を使って注釈を付けられた要素を返します。 注釈は、直接使用されていても、継承されていてもかまいません。 この注釈処理ラウンドのパッケージ要素、モジュール要素、および型要素included、またはそれらの中で宣言されたメンバー、コンストラクタ、パラメータ、または型パラメータの宣言のみが返されます。 含まれる型要素は、ルートの型と、それらの内側にネストされたすべてのメンバーの型です。 あるパッケージ内の要素は、含まれているとはみなされません。その理由は単純で、そのパッケージのpackage-info
ファイルが作成されたからです。 同様に、モジュールの要素は、そのモジュールのmodule-info
ファイルが作成されたために含まれているとはみなされません- パラメータ:
a
- 要求された注釈型- 戻り値:
- 指定された注釈型を使って注釈を付けられた要素。存在しない場合は空のセット
- 例外:
IllegalArgumentException
- 引数が注釈型を表していない場合
-
getElementsAnnotatedWithAny
default Set<? extends Element> getElementsAnnotatedWithAny(Set<Class<? extends Annotation>> annotations)
指定された注釈型の1つ以上で注釈が付けられた要素を返します。- APIの注:
- このメソッドは、注釈型とその注釈型を同時に検索して繰り返し注釈を処理する場合に役立ちます。
- 実装要件:
- このメソッドのデフォルトの実装では空の結果セットが作成され、引数セットの注釈を繰り返して各注釈に
getElementsAnnotatedWith(Class)
を呼び出し、その結果を結果セットに追加します。 最後に、結果セットの内容は変更不可能なセットとして返されます。 - パラメータ:
annotations
- 注釈型がリクエストされている- 戻り値:
- 指定された注釈型の1つ以上で注釈された要素、または存在しない場合は空のセット
- 例外:
IllegalArgumentException
- 引数セットの任意の要素が注釈型を表さない場合- 導入されたバージョン:
- 9
- Java™言語仕様:
- 9.6.3反復可能な注釈型
-
-