io.micronaut.aop

Interface Interceptor<T,R>

Type Parameters:

T - The intercepted type

R - The result type

All Superinterfaces:

Ordered

All Known Subinterfaces:

MethodInterceptor<T,R>

All Known Implementing Classes:

AsyncInterceptor, ClientWebSocketInterceptor, ConfigurationIntroductionAdvice, DefaultRetryInterceptor, FunctionClientAdvice, HttpClientIntroductionAdvice, RecoveryInterceptor, RefreshInterceptor, TraceInterceptor, 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 and Singleton scoped 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 java.lang.CharSequence	HOTSWAP The Around.hotswap() setting.
static java.lang.CharSequence	LAZY The Around.lazy() setting.
static java.lang.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

PROXY_TARGET

static final java.lang.CharSequence PROXY_TARGET

The Around.proxyTarget() setting.

HOTSWAP

static final java.lang.CharSequence HOTSWAP

The Around.hotswap() setting.

LAZY

static final java.lang.CharSequence LAZY

The Around.lazy() 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