org.jboss.weld.ejb.spi

Interface InterceptorBindings

All Known Implementing Classes:

InterceptorBindingsAdapter

public interface InterceptorBindings

Author:

Marius Bogoevici

Method Summary

Modifier and Type	Method and Description
Collection<Interceptor<?>>	getAllInterceptors() Returns all interceptors that are bound to an EJB object through the InterceptorBinding mechanism and are enabled through the beans.xml file.
List<Interceptor<?>>	getLifecycleInterceptors(InterceptionType interceptionType) Returns the lifecycle interceptors that are applicable to a given InterceptionType (bound by InterceptorBinding).
List<Interceptor<?>>	getMethodInterceptors(InterceptionType interceptionType, Method method) Returns the interceptors that are applicable to a given InterceptionType and method (bound by InterceptorBinding).

Method Detail

getAllInterceptors

Collection<Interceptor<?>> getAllInterceptors()

Returns all interceptors that are bound to an EJB object through the InterceptorBinding mechanism and are enabled through the beans.xml file. This includes class and method-bound interceptors.The purpose of this method is to indicate what interceptors does the container need to interact with, for a given EJB. Note: in the case of an EJB, the expectation is that the interpretation of {link @javax.interceptor.Interceptors} is left to the container, and the interceptors provided by the binding are complementary

Returns:

all interceptors that are bound to an EJB object through the InterceptorBinding mechanism and are enabled

getMethodInterceptors

List<Interceptor<?>> getMethodInterceptors(InterceptionType interceptionType,
                                           Method method)

Returns the interceptors that are applicable to a given InterceptionType and method (bound by InterceptorBinding). This includes class and method-bound interceptors, but no interceptors bound by EJB-specific mechanisms.

Parameters:

interceptionType - - the interception type (non-lifecycle)

method - - the method that is to be intercepted

Returns:

- an immutable list of interceptors applicable to the method (empty if no such interceptors exist)

Throws:

IllegalArgumentException - if interceptionType is not InterceptionType.AROUND_INVOKE or InterceptionType.AROUND_TIMEOUT

getLifecycleInterceptors

List<Interceptor<?>> getLifecycleInterceptors(InterceptionType interceptionType)

Returns the lifecycle interceptors that are applicable to a given InterceptionType (bound by InterceptorBinding). This includes class and method-bound interceptors, but no interceptors bound by EJB-specific mechanisms.

Parameters:

interceptionType - - the interception type (lifecycle)

Returns:

- an immutable list of interceptors applicable to the method (empty if no such interceptors exist)

Throws:

IllegalArgumentException - if interceptionType not InterceptionType.AROUND_INVOKE or InterceptionType.AROUND_TIMEOUT