Что такое retention policy аннотаций и как она влияет на их использование?

Retention policy определяет, как долго аннотация «живет» после компиляции.

Что такое retention policy

Retention policy — это правило, задающее этап доступности аннотации.

В Java существует три варианта:

• SOURCE

• CLASS

• RUNTIME

SOURCE

Аннотация:

• доступна только в исходном коде

• отбрасывается компилятором

• не попадает в .class файл

Используется для:

• подсказок компилятору

• статического анализа

• документации

Пример:

@Override

CLASS

Аннотация:

• сохраняется в байткоде

• недоступна через reflection

• используется инструментами на этапе сборки

Применяется редко и обычно для:

• bytecode-инструментов

• code generation

RUNTIME

Аннотация:

• сохраняется в байткоде

• доступна через reflection во время выполнения

Именно этот вариант нужен:

• Spring

• Hibernate

• Jackson

Пример:

@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {}

Почему это важно

Если аннотация:

• нужна фреймворку → RUNTIME

• нужна только компилятору → SOURCE

Неправильный retention:

• ломает функциональность

• не дает ошибок компиляции

• проявляется только в runtime

Вывод: retention policy определяет, кто и когда может использовать аннотацию, и напрямую влияет на ее работоспособность.