Изучаем Java EE 7

Если вы посмотрите на листинг 2.25, то увидите, как работают перехватчики. Реализацию перехватчика необходимо указывать непосредственно на реализации компонента (например, @Interceptors(LoggingInterceptror.class)). Это типобезопасно, но нет слабой связи. CDI обеспечивает связывание с перехватчиком, которое представляет определенный уровень косвенности и слабой связанности. Тип связывания с перехватчиком — это определенная пользователем аннотация, также сопровождаемая аннотацией @InterceptorBinding, которая связывает класс перехватчика с компонентом без прямой зависимости между этими двумя классами.

Листинг 2.29 показывает связывание с перехватчиком под названием Loggable. Как видите, данный код очень похож на квалификатор. Связывание с перехватчиком — это аннотация, также аннотированная @InterceptorBinding, которая может быть пустой или иметь члены (например, как в листинге 2.13).

Листинг 2.29. Связывание с перехватчиком Loggable

@InterceptorBinding

@Target({METHOD, TYPE})

@Retention(RUNTIME)

public @interface Loggable { }

При наличии связывания с перехватчиком необходимо прикрепить его к самому перехватчику. Для этого к перехватчику добавляется аннотация @Interceptor и связывание с перехватчиком (Loggable в листинге 2.30).

Листинг 2.30. Перехватчик Loggable

@Interceptor

@Loggable

public class LoggingInterceptor {

··@Inject

··private Logger logger;

··@AroundInvoke

··public Object logMethod(InvocationContext ic) throws Exception {

····logger.entering(ic.getTarget(). toString(), ic.getMethod(). getName());

····try {

······return ic.proceed();

····} finally {

······logger.exiting(ic.getTarget(). toString(), ic.getMethod(). getName());

····}

··}

}

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

Листинг 2.31. CustomerService, использующий связку перехватчиков

@Transactional

@Loggable

public class CustomerService {

··@Inject

··private EntityManager em;

··public void createCustomer(Customer customer) {

····em.persist(customer);

··}

··public Customer findCustomerById(Long id) {

····return em.find(Customer.class, id);

··}

}

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

@Transactional

public class CustomerService {

··@Loggable

··public void createCustomer(Customer customer) {…}

··public Customer findCustomerById(Long id) {…}

}

Перехватчики специфичны для развертывания и отключены по умолчанию. Как и альтернативы, перехватчики необходимо активизировать, используя дескриптор развертывания beans.xml JAR-файла или модуля Java EE, как показано в листинге 2.32.

Листинг 2.32. Активизация перехватчика в дескрипторе развертывания beans.xml

·······xmlns: xsi="http://www.w3.org/2001/XMLSchema-instance"

·······xsi: schemaLocation="http://xmlns.jcp.org/xml/ns/javaee 

····························http://xmlns.jcp.org/xml/ns/javaee/beans_1_1.xsd"

·······version="1.1" bean-discovery-mode="all">

··

····org.agoncal.book.javaee7.chapter02.LoggingInterceptor

··

Приоритизация связывания перехватчиков