Java Academy · Урок

Политики хранения и типы целей

Выбирайте хранение SOURCE, CLASS или RUNTIME и ограничивайте целевые элементы с помощью @Target.

Урок 2 из 413 шагов

«Политики хранения и типы целей» — бесплатный урок Java Academy на CoddyKit. Это урок 2 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Java Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Java Academy содержит 4 уроков всего.

Три политики сохранения

SOURCE: отбрасывается компилятором (полезна только для APT). CLASS: записывается в файлы .class, но недоступна во время выполнения. RUNTIME: доступна через рефлексию. В большинстве аннотаций фреймворков используется RUNTIME.

Сохранение SOURCE: только во время компиляции

Аннотации SOURCE обрабатываются процессорами аннотаций, а затем отбрасываются. @Override и @SuppressWarnings имеют политику SOURCE: они информируют компилятор, но не попадают в файл .class.

@Retention(RetentionPolicy.SOURCE)
public @interface GenerateBuilder {}
// APT generates a Builder class when it sees @GenerateBuilder
// The annotation itself disappears from the compiled output

Сохранение CLASS: анализ байт-кода

Аннотации CLASS включаются в файлы .class для инструментов анализа байт-кода (PMD, FindBugs, ASM), но НЕ доступны во время выполнения через рефлексию.

@Retention(RetentionPolicy.CLASS)
public @interface ThreadSafe {}
// Visible in bytecode, invisible to Class.getAnnotation() at runtime

Сохранение RUNTIME: обработка через рефлексию

Аннотации RUNTIME сохраняются во время выполнения, и их можно прочитать с помощью getAnnotation(). Spring, JUnit, Jackson и Hibernate используют сохранение RUNTIME.

@Retention(RetentionPolicy.RUNTIME)
public @interface Route {
    String path();
    String method() default "GET";
}
// At runtime:
Route r = handler.getClass().getMethod("handle").getAnnotation(Route.class);
System.out.println(r.path()); // e.g. "/users"

@Target: ограничение мест применения

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

import static java.lang.annotation.ElementType.*;
@Target({METHOD, CONSTRUCTOR})
@Retention(RetentionPolicy.RUNTIME)
public @interface Measured {}

Все значения ElementType

Полный список: TYPE (класс, интерфейс или перечисление), FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, ANNOTATION_TYPE, PACKAGE, TYPE_PARAMETER (параметр обобщённого типа), TYPE_USE (любое использование типа).

// TYPE_USE: annotate any type reference
@NotNull String name;
List<@NonNull String> items;
public @Valid User createUser(@NotNull String name) { ... }

TYPE и TYPE_USE

TYPE применяется к объявлениям классов, интерфейсов и перечислений. TYPE_USE (начиная с Java 8) применяется к любому использованию типа, включая обобщённые типы, приведения и конструкции extends, что позволяет использовать аннотации безопасности типов относительно null.

@Target(ElementType.TYPE_USE)
@interface NonNull {}
// Can be applied to:
List<@NonNull String> list;
@NonNull String result = (@NonNull String) obj;

Объединение Target и Retention

Большинство полезных аннотаций фреймворков объединяют сохранение RUNTIME с определёнными целевыми элементами. Например, аннотация проверки, применяемая только к полям.

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Range {
    int min() default 0;
    int max() default Integer.MAX_VALUE;
}

Наследование аннотаций с помощью @Inherited

@Inherited — это мета-аннотация, из-за которой аннотации на уровне класса наследуются подклассами. На аннотации методов или полей она не влияет.

@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@interface Framework {}
@Framework class Base {}
class Child extends Base {} // @Framework visible on Child too

@Documented: включение в Javadoc

Примените @Documented, чтобы аннотация появилась в сгенерированной документации Javadoc для аннотированных элементов. Без неё аннотации не отображаются в документации API.

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface Auditable {
    String description() default "";
}

Чтение сведений о сохранении во время выполнения

Вы можете проверить сохранение самого типа аннотации, вызвав getAnnotation(Retention.class) для объекта класса аннотации.

Retention r = Retry.class.getAnnotation(Retention.class);
System.out.println(r.value()); // RUNTIME, CLASS, or SOURCE

Быстрая проверка

Какой ElementType охватывает объявления классов, интерфейсов и перечислений?

Ответь в интерактивном уроке

Итоги

Используйте SOURCE для инструментов времени компиляции, CLASS для анализа байт-кода и RUNTIME для фреймворков, работающих через рефлексию. Ограничивайте применение с помощью @Target, чтобы предотвратить неправильное использование. Добавляйте @Documented для аннотаций API и @Inherited для аннотаций иерархий классов.

Можно начать бесплатно

Изучай Java с ИИ-репетитором — бесплатно

Пиши и запускай код прямо в браузере, получай мгновенную помощь от ИИ-репетитора 24/7 и продолжи учиться на сайте или в приложении.

Курсы: 104
Уроки: 374

Начать учиться бесплатно Посмотреть полный курс

Часто задаваемые вопросы

Урок «Политики хранения и типы целей» бесплатный?

Да — полный текст урока «Политики хранения и типы целей» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Java Academy, подпишись на CoddyKit PRO. Курс Java Academy содержит 4 уроков всего.

Чему я научусь в уроке «Политики хранения и типы целей»?

Выбирайте хранение SOURCE, CLASS или RUNTIME и ограничивайте целевые элементы с помощью @Target. Ты практикуешь Java Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Java Academy?

Предыдущий опыт не требуется. Java Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 4.

Сколько времени занимает урок «Политики хранения и типы целей»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Java Academy?

Да. Каждый урок Java Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

Определение аннотаций: элементы и значения по умолчанию
Политики хранения и типы целей
Обработка аннотаций во время выполнения
Процессоры аннотаций во время компиляции

← Назад к Java Academy