Ответ.

История вопроса:

Аннотации появились в Java 5, чтобы добавить метаинформацию в байткод без изменения самой логики программы. С помощью аннотаций легко снабжать классы и методы дополнительной информацией для фреймворков, компиляторов или парсеров.

Проблема:

Плохо спроектированные или неправильно использованные аннотации приводят к усложнению поддержки кода. Иногда разработчики путают применимость аннотаций или не понимают, как делать свои собственные, и не знают о возможности делать аннотации с параметрами.

Решение:

Создание собственной аннотации:

import java.lang.annotation.*;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MyTest {
    String value() default "";
}

Использование аннотации:

public class TestClass {
    @MyTest("Example")
    public void testMethod() {...}
}

Ключевые особенности:

Аннотации могут иметь параметры с дефолтными значениями
Аннотация должна быть снабжена мета-аннотациями @Target и @Retention
Использование Runtime Retention позволяет использовать аннотацию через Reflection

Вопросы с подвохом.

Может аннотация наследоваться от другой аннотации?

Ответ: Нет, аннотации в Java не поддерживают наследование между собой.

Можно ли сделать работу аннотации обязаловкой во всех наследниках класса?

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

Чем @Retention(Class) отличается от @Retention(RUNTIME)?

Ответ:

@Retention(RUNTIME): аннотация доступна во время выполнения через рефлексию
@Retention(CLASS): аннотация сохраняется в байткоде, но недоступна через Reflection (используется только компилятором)

Типовые ошибки и анти-паттерны

Не указывать @Target и @Retention для своих аннотаций
Использовать аннотации не по назначению (например, обрабатывать их не теми инструментами или вне предназначенной среды)

Пример из жизни

Негативный кейс

В проекте решили заменить конфигурацию через xml на аннотации, но не добавили @Retention(RUNTIME)

Плюсы:

Код стал выглядеть компактнее

Минусы:

Аннотации не видны в runtime, фреймворк не может их обрабатывать

Позитивный кейс

Настроили кастомную аннотацию @Audit у методов, контролирующую аудит бизнес-операций, с рефлексией реального вызова логики на сервере.