@Documented
@Retention(RUNTIME)
@Target(ANNOTATION_TYPE)
public @interface Target

注釈型が適用可能なコンテキストを示します。注釈型を適用できる可能性のある宣言コンテキストおよび型コンテキストは、JLS 9.6.4.1に明記されており、java.lang.annotation.ElementTypeの列挙型定数によってソース・コード内に示されます。

注釈型Tに@Targetメタ注釈が存在しない場合、型パラメータ宣言を除くすべての宣言の修飾子として、型Tの注釈を記述できます。

@Targetメタ注釈が存在する場合、コンパイラは、JLS 9.7.4に基づいてElementTypeの列挙型定数で指定された使用制限を強制します。

たとえば、この@Targetメタ注釈は、宣言された型自体がメタ注釈型であることを示します。これは注釈型宣言でのみ使用可能です。

    @Target(ElementType.ANNOTATION_TYPE)
    public @interface MetaAnnotationType {
        ...
    }

この@Targetメタ注釈は、宣言された型の使用目的が複雑な注釈型宣言のメンバー型だけであることを示します。これは直接的な注釈には使用できません。

    @Target({})
    public @interface MemberType {
        ...
    }

1つのElementType定数が@Target注釈内に複数回表示されるとコンパイル時エラーになります。たとえば、次の@Targetメタ注釈は不正です。

    @Target({ElementType.FIELD, ElementType.METHOD, ElementType.FIELD})
    public @interface Bogus {
        ...
    }

注釈型Target

必須要素のサマリー