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.14. 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
With this approach, you create aMETA-INF/services/org.jboss.ejb.client.EJBClientInterceptor
file and place or package 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 a separate line for each 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. Theejb-security-interceptors
quickstart uses this approach.