Аннотация в Java EE

#java #java_ee #аннотации

Всем привет. Хотел узнать у знающих, что такое аннотации, и зачем они нужны. 
До того как начал изучать Java EE у меня было представление, что я знаю, что это
такое. Но как дошел до Java EE, увидел, что они применяются везде особенно в JAX-RS
и при написании веб сервисов. 

Зашел в документацию прочитать про @Context и посмотреть что там внутри. Вот то,
что увидел, если кто сможет объяснить синтаксис и саму логику данного кода буду признателен.
Если есть ссылки на объяснение буду рад почитать.   

 @Target({ElementType.PARAMETER, ElementType.METHOD, ElementType.FIELD})
 @Retention(RetentionPolicy.RUNTIME)
 @Documented
 public @interface Context {
 }

    

Ответы

Ответ 1

Это просто объявление аннотации без какой-либо логики. Как объявить аннотацию, рассказывается
в любом учебнике по Java. 

По-порядку:

@Target({ElementType.PARAMETER, ElementType.METHOD, ElementType.FIELD})


Аннотация @Target, объявляет элементы исходного кода, к которым можно применить создаваемую
аннотацию. В данном случае это: параметры методов (ElementType.PARAMETER), сами методы
(ElementType.METHOD) и поля классов (ElementType.FIELD).

@Retention(RetentionPolicy.RUNTIME)


Аннотация @Retention, говорит компилятору, как долго нужно хранить аннотацию в коде.
Политика RetentionPolicy.RUNTIME заставляет компилятор сохранить аннотации в .class-файлах
и делает их доступными во время выполнения программы через рефлексию.

@Documented


Аннотация @Documented включает создаваемую аннотацию в список элементов исходного
кода, для которых генерируется документация (при использовании инструментов генерации
документации).

public @interface Context { }


Это, собственно, непосредственно объявление новой аннотации @Context.



Сами по себе аннотации - просто маркеры, никакой работы они не выполняют.

Что касается логики ("магии") аннотаций то обычно это работает так: есть какой-то
класс, отвечающий за инициализацию, он пробегает при помощи рефлексии по классам в
определенном пакете и ищет какую-то аннотацию. Если находит - экземпляры этого класса
подвергаются какой-либо обработке, например полям классов задаются некоторые значения. 

В случае с JAX-RS "магией" занимается поставщик реализации (напр. CXF, Jersey, RESTEasy).
Где-то в его недрах есть класс, который анализирует аннотации, которыми вы украсили
ваши ресурсы и выполняет действия в соответствии со спецификацией JAX-RS. Например,
составляет карту соответствий URL-ов конкретным методам, на основе аннотаций @Path
и @GET/@PUT/@POST/@DELETE.


Ответ 2

Пример на основе этой статьи:

1) Создаем новый класс-аннотацию:

@Target(value= ElementType.TYPE)
@Retention(value= RetentionPolicy.RUNTIME)
public @interface ControlledObject {
    String name();
}


2) Используем эту аннотацию, т.е. аннотируем класс:

@ControlledObject(name="biscuits")
public class Cookies {
...
}


3) Как работает аннотация: где-то в коде мы проверяем, аннотирован ли наш класс Cookies
этой аннотацией, ControlledObject. Если да, то выполняются одни действия, если нет
- другие: 

Class cl = Class.forName("Cookies");
if(!cl.isAnnotationPresent(ControlledObject.class)){
...
}
else {
...
}