javax.enterprise.inject.spi

Interface Interceptor<T>

Type Parameters:

T -

All Superinterfaces:

Bean<T>, BeanAttributes<T>, Contextual<T>

public interface Interceptor<T>
extends Bean<T>

A Bean for creating and using an interceptor. A CDI interceptor is always a separate dependent instance for each intercepted class. It will get created when the intercepted bean gets created and destroyed when the intercepted bean gets destroyed.

Method Summary

Modifier and Type	Method and Description
Set<Annotation>	getInterceptorBindings() Usually a single Interceptor
Object	intercept(InterceptionType type, T instance, javax.interceptor.InvocationContext ctx) Perform the interception.
boolean	intercepts(InterceptionType type)

Methods inherited from interface javax.enterprise.inject.spi.Bean

getBeanClass, getInjectionPoints, isNullable

Methods inherited from interface javax.enterprise.context.spi.Contextual

create, destroy

Methods inherited from interface javax.enterprise.inject.spi.BeanAttributes

getName, getQualifiers, getScope, getStereotypes, getTypes, isAlternative

Method Detail

getInterceptorBindings

Set<Annotation> getInterceptorBindings()

Usually a single Interceptor

Returns:

all InterceptorBindings handled by this interceptor.

intercepts

boolean intercepts(InterceptionType type)

Parameters:

type - InterceptionType in question

Returns:

true if this interceptor handles the given InterceptionType, false otherwise

intercept

Object intercept(InterceptionType type,
                 T instance,
                 javax.interceptor.InvocationContext ctx)
          throws Exception

Perform the interception. This will e.g. invoke the @AroundInvoke annotated method on the given instance of T.

Parameters:

type - the InterceptionType. This is important if an interceptor has multiple interceptor methods e.g. one @AroundInvoke and one @PostConstruct;

instance - the interceptor instance

ctx - the InvocationContext contains all the interceptor chain state for a single invocation.

Returns:

the object or wrapper type returned by the intercepted instance or the previous interceptor (if this is not the last interceptor in the chain)

Throws:

Exception - wrapped from the intercepted instance. See CDI-115