Целевой интерфейс аннотации

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

Указывает контексты, в которых применим интерфейс аннотации. Контексты объявления и контексты типов, в которых может быть применим интерфейс аннотации, указаны в JLS 9.6.4.1 и обозначены в исходном коде константами перечисления java.lang.annotation.ElementType.

Если @Target мета-аннотация отсутствует на интерфейсе аннотации T, то аннотация типа T может быть записана как модификатор для любого объявления.

Если присутствует @Target мета-аннотация, компилятор будет применять ограничения, указанные константами перечисления ElementType, в соответствии с JLS 9.7.4.

Например, эта @Target мета-аннотация указывает, что объявленный интерфейс сам по себе является интерфейсом мета-аннотации. Он может использоваться только для объявления интерфейсов аннотаций:

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

Эта @Target мета-аннотация указывает, что объявленный класс или интерфейс предназначен исключительно для использования в качестве вложенного класса или интерфейса в сложных объявлениях интерфейсов аннотаций. Его нельзя использовать для непосредственного аннотирования:

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

Является ошибкой времени компиляции, если одна ElementType константа появляется более одного раза в @Target аннотации. Например, следующая @Target мета-аннотация недопустима:

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