io.micronaut.aop

Interface Interceptor<T,R>

Type Parameters:

T - The intercepted type

R - The result type

All Superinterfaces:

Ordered

All Known Subinterfaces:

ConstructorInterceptor<T>, MethodInterceptor<T,R>

All Known Implementing Classes:

AsyncInterceptor, ClientWebSocketInterceptor, ConfigurationIntroductionAdvice, DefaultRetryInterceptor, FunctionClientAdvice, HttpClientIntroductionAdvice, RecoveryInterceptor, RefreshInterceptor, ValidatingInterceptor

@Indexed(value=Interceptor.class)
public interface Interceptor<T,R>
extends Ordered

An Interceptor intercepts the execution of a method allowing cross cutting behaviour to be applied to a method's execution.

All implementations should be thread safe beans

In the case of Around advice the interceptor should invoke InvocationContext.proceed() to proceed with the method invocation

In the case of Introduction advice the interceptor should invoke InvocationContext.proceed() if it is unable to implement the method. The last call to InvocationContext.proceed() will produce a UnsupportedOperationException indicating the method cannot be implemented. This mechanism allows multiple possible interceptors to participate in method implementation.

Since:

1.0

Author:

Graeme Rocher

Field Summary

Fields

Modifier and Type	Field and Description
static Argument<Interceptor<?,?>>	ARGUMENT
static CharSequence	CACHEABLE_LAZY_TARGET The Around.cacheableLazyTarget() setting.
static CharSequence	HOTSWAP The Around.hotswap() setting.
static CharSequence	LAZY The Around.lazy() setting.
static CharSequence	PROXY_TARGET The Around.proxyTarget() setting.

Fields inherited from interface io.micronaut.core.order.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Method Summary

Modifier and Type	Method and Description
R	intercept(InvocationContext<T,R> context) Intercepts an execution from a declared Around advice.

Methods inherited from interface io.micronaut.core.order.Ordered

getOrder

Field Detail

ARGUMENT

static final Argument<Interceptor<?,?>> ARGUMENT

PROXY_TARGET

static final CharSequence PROXY_TARGET

The Around.proxyTarget() setting.

HOTSWAP

static final CharSequence HOTSWAP

The Around.hotswap() setting.

LAZY

static final CharSequence LAZY

The Around.lazy() setting.

CACHEABLE_LAZY_TARGET

static final CharSequence CACHEABLE_LAZY_TARGET

The Around.cacheableLazyTarget() setting.

Method Detail

intercept

R intercept(InvocationContext<T,R> context)

Intercepts an execution from a declared Around advice. The implementation can either call InvocationContext.proceed() to return the original value or provide a replacement value

Parameters:

context - The interception context

Returns:

result type