Энтони Гонсалвес - Изучаем Java EE 7

@InterceptorBinding

@Target({METHOD, TYPE})

@Retention(RUNTIME)

public @interface Loggable { }

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

@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. Это дает вам слабую связанность (так как класс реализации явно не указывается) и неплохой уровень косвенности.

@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.

·······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

··

Связывание перехватчиков обеспечивает определенный уровень косвенности, однако лишает возможности упорядочивать перехватчики, как показано в листинге 2.28 (@Interceptors({I1.class, I2.class})). Согласно CDI 1.1 вы можете приоритизировать их, используя аннотацию @javax.annotation.Priority (либо ее XML-эквивалент в файле beans.xml) вместе со значением приоритета, как показано в листинге 2.33.

@Interceptor

@Loggable

@Priority(200)

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());

····}

··}

}

Аннотация @Priority берет целое число, которое может принимать любое значение. Правило состоит в том, что перехватчики с меньшим приоритетом называются первыми. Java EE 7 определяет приоритеты уровня платформы, после чего ваши перехватчики могут вызываться до или после определенных событий. Аннотация javax.interceptor.Interceptor определяет следующий набор констант:

• PLATFORM_BEFORE = 0 — начинает диапазон для ранних перехватчиков, определяемых платформой Java EE;

• LIBRARY_BEFORE = 1000 — открывает диапазон для ранних перехватчиков, задаваемых библиотеками расширения;

• APPLICATION = 2000 — начинает диапазон для ранних перехватчиков, определяемых приложениями;

• LIBRARY_AFTER = 3000 — открывает диапазон для поздних перехватчиков, задаваемых библиотеками расширения;

• PLATFORM_AFTER = 4000 — начинает диапазон для поздних перехватчиков, определяемых платформой Java EE.

Поэтому, если вы хотите, чтобы ваш перехватчик выполнялся до любого перехватчика приложения, но после любого раннего перехватчика платформы, можете написать следующее: