7.6.6. Use a Client Side Interceptor in an Application
Summary
You can plug a client-side interceptor into an application programmatically or using a ServiceLoader mechanism. The following procedure describes the two methods.
Procedure 7.13. Plug the Interceptor into
Programmatically
With this approach, you call theorg.jboss.ejb.client.EJBClientContext.registerInterceptor(int order, EJBClientInterceptor interceptor)
API and pass theorder
and theinterceptor
instance. Theorder
is used to determine where exactly in the client interceptor chain thisinterceptor
is placed.ServiceLoader Mechanism
This approach requires the creation of aMETA-INF/services/org.jboss.ejb.client.EJBClientInterceptor
file and placing or packaging it in the classpath of the client application. The rules for the file are dictated by the Java ServiceLoader Mechanism. This file is expected to contain in each separate line the fully qualified class name of the EJB client interceptor implementation. The EJB client interceptor classes must be available in the classpath. EJB client interceptors added using theServiceLoader
mechanism are added to the end of the client interceptor chain, in the order they are found in the classpath.