··}
}
В листинге 2.25 аннотация @Interceptors прикрепляется только к методу createCustomer(). Это означает, что, если клиент вызывает findCustomerById(), контейнер не будет перехватывать вызов. Если вы хотите, чтобы перехватывались вызовы обоих методов, можете добавить аннотацию @Interceptors либо сразу к обоим методам, либо к самому компоненту. Когда вы это делаете, перехватчик приводится в действие при вызове любого из методов. А поскольку перехватчик имеет аннотацию @AroundConstruct, вызов конструктора тоже будет перехвачен.
@Transactional
@Interceptors(LoggingInterceptor.class)
public class CustomerService {
··public void createCustomer(Customer customer) {…}
··public Customer findCustomerById(Long id) {…}
}
Если ваш компонент имеет несколько методов и вы хотите применить перехватчик ко всему компоненту за исключением определенного метода, можете использовать аннотацию javax.interceptor.ExcludeClassInterceptors для исключения перехвата вызова. В следующем отрывке кода вызов к updateCustomer() не будет перехвачен, а остальные будут:
@Transactional
@Interceptors(LoggingInterceptor.class)
public class CustomerService {
··public void createCustomer(Customer customer) {…}
··public Customer findCustomerById(Long id) {…}
··@ExcludeClassInterceptors
··public Customer updateCustomer(Customer customer) {… }
}
Перехватчик жизненного цикла
В начале этой главы я рассказывал о жизненном цикле управляемого компонента (см. рис. 2.2) и событиях обратного вызова. С помощью аннотации обратного вызова вы можете дать контейнеру команду вызвать метод в определенной фазе жизненного цикла (@PostConstruct и @PreDestroy). Например, если вы хотите вносить в журнал запись каждый раз, когда создается экземпляр компонента, вам просто нужно присоединить аннотацию @PostConstruct к методу вашего компонента и добавить к ней некоторые механизмы записи в журнал. Но что, если вам нужно перехватывать события жизненного цикла многих типов компонентов? Перехватчики жизненного цикла позволяют изолировать определенный код в отдельный класс и вызывать его, когда приводится в действие событие жизненного цикла.
Листинг 2.26 демонстрирует класс ProfileInterceptor с двумя методами: logMethod(), который используется для постконструкции, и profile(), применяемый для перехвата методов (@AroundInvoke).
public class ProfileInterceptor {
··@Inject
··private Logger logger;
··@PostConstruct
··public void logMethod(InvocationContext ic) throws Exception {
····logger.fine(ic.getTarget(). toString());
····try {
······ic.proceed();
····} finally {
······logger.fine(ic.getTarget(). toString());
····}
··}
··@AroundInvoke
··public Object profile(InvocationContext ic) throws Exception {
····long initTime = System.currentTimeMillis();
····try {
······return ic.proceed();
····} finally {
······long diffTime = System.currentTimeMillis() — initTime;
······logger.fine(ic.getMethod() + " took " + diffTime + " millis");
····}
··}
}
Как видно из листинга 2.26, перехватчики жизненного цикла берут параметр InvocationContext и вместо Object возвращают void. Чтобы применить перехватчик, определенный в листинге 2.26, компонент CustomerService (листинг 2.27) должен использовать аннотацию @Interceptors и определять ProfileInterceptor. Если компонент инстанцируется контейнером, метод logMethod() будет вызван раньше метода init(). Затем, если клиент вызывает createCustomer() или findCustomerById(), будет вызван метод profile().
@Transactional
@Interceptors(ProfileInterceptor.class)
public class CustomerService {
··@Inject
··private EntityManager em;
··@PostConstruct
··public void init() {
····//…
··}
··public void createCustomer(Customer customer) {
····em.persist(customer);
··}
··public Customer findCustomerById(Long id) {
····return em.find(Customer.class, id);
··}
}
Связывание и исключение перехватчиков
Вы уже видели, как перехватываются вызовы в пределах одного компонента (с аннотацией @Around Invoke), а также среди множественных компонентов (с использованием аннотации @Interceptors). Спецификация Interceptors 1.2 также позволяет связать в цепочку несколько перехватчиков.
В действительности аннотация @Interceptors способна прикреплять более одного перехватчика, так как в качестве параметра она берет список перехватчиков, разделенных запятой. Когда определяются множественные перехватчики, порядок их вызова задается тем порядком, в котором они указаны в аннотации @Interceptors. Например, код в листинге 2.28 использует аннотацию @Interceptors у компонента и на уровне методов.