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

@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 {
        ...
    }