Class MethodInterceptorChain<T,R>

java.lang.Object

io.micronaut.aop.chain.InterceptorChain<T,R>

io.micronaut.aop.chain.MethodInterceptorChain<T,R>

Type Parameters:

T - type

R - result

All Implemented Interfaces:

InvocationContext<T,R>, MethodInvocationContext<T,R>, AnnotatedElement, AnnotationMetadata, AnnotationMetadataDelegate, AnnotationMetadataProvider, AnnotationSource, AttributeHolder, MutableAttributeHolder, Described, Named, Executable<T,R>, ExecutableMethod<T,R>, MethodReference<T,R>

@Internal
public final class MethodInterceptorChain<T,R>
extends InterceptorChain<T,R>
implements MethodInvocationContext<T,R>

An internal representation of the Interceptor chain. This class implements MethodInvocationContext and is consumed by the framework itself and should not be used directly in application code.

Since:

1.0

Author:

Graeme Rocher

Field Summary

Fields

Modifier and Type	Field	Description
protected @Nullable MutableConvertibleValues<Object>	attributes
protected int	index
protected final int	interceptorCount
protected final Interceptor<T,R>[]	interceptors
protected static final org.slf4j.Logger	LOG	Used by subclasses!
protected final @Nullable Object[]	originalParameters
protected @Nullable Map<String, MutableArgumentValue<?>>	parameters

Fields inherited from class InterceptorChain

executionHandle, target

Fields inherited from interface AnnotationMetadata

CLASS_NAME_SUFFIX, EMPTY_METADATA, VALUE_MEMBER

Fields inherited from interface AnnotationSource

EMPTY

Constructor Summary

Constructors

Constructor	Description
MethodInterceptorChain(Interceptor<T,R>[] interceptors, T target, ExecutableMethod<T,R> executionHandle)	Constructor for empty parameters.
MethodInterceptorChain(Interceptor<T,R>[] interceptors, T target, ExecutableMethod<T,R> executionHandle, @Nullable InterceptorKind kind)	Constructor for empty parameters.
MethodInterceptorChain(Interceptor<T,R>[] interceptors, T target, ExecutableMethod<T,R> executionHandle, @Nullable Object... originalParameters)	Constructor.

Method Summary

Modifier and Type	Method	Description
static <T1> @Nullable T1	dispose(BeanResolutionContext resolutionContext, BeanContext beanContext, BeanDefinition<T1> definition, ExecutableMethod<T1,T1> preDestroyMethod, T1 bean)	Internal method that handles the logic for executing InterceptorKind.PRE_DESTROY interception.
static <T1> @Nullable T1	dispose(BeanResolutionContext resolutionContext, BeanContext beanContext, BeanDefinition<T1> definition, ExecutableMethod<T1,T1> preDestroyMethod, T1 bean, @Nullable Collection<BeanRegistration<Interceptor<?,?>>> interceptors)	Variant of dispose(BeanResolutionContext, BeanContext, BeanDefinition, ExecutableMethod, Object) that reuses registrations already resolved for this bean.
Class<?>[]	getArgumentTypes()
MutableConvertibleValues<Object>	getAttributes()	Overrides the default AttributeHolder.getAttributes() method to return a mutable object.
Class<T>	getDeclaringType()
ExecutableMethod<T,R>	getExecutableMethod()	The underlying ExecutableMethod reference.
InterceptorKind	getKind()
String	getMethodName()
Map<String, MutableArgumentValue<?>>	getParameters()	Returns the current parameters as a map of mutable argument values.
@Nullable Object[]	getParameterValues()	Returns the current state of the parameters as an array by parameter index.
ReturnType<R>	getReturnType()
Method	getTargetMethod()
static <T1> @Nullable T1	initialize(BeanResolutionContext resolutionContext, BeanContext beanContext, BeanDefinition<T1> definition, ExecutableMethod<T1,T1> postConstructMethod, T1 bean)	Internal method that handles the logic for executing InterceptorKind.POST_CONSTRUCT interception.
static <T1> @Nullable T1	initialize(BeanResolutionContext resolutionContext, BeanContext beanContext, BeanDefinition<T1> definition, ExecutableMethod<T1,T1> postConstructMethod, T1 bean, @Nullable Collection<BeanRegistration<Interceptor<?,?>>> interceptors)	Variant of initialize(BeanResolutionContext, BeanContext, BeanDefinition, ExecutableMethod, Object) that reuses registrations already resolved for this bean.
@Nullable R	invoke(T instance, @Nullable Object... arguments)	Invokes the method.
boolean	isAbstract()	Defines whether the method is abstract.
boolean	isSuspend()	Defines whether the method is Kotlin suspend function.
@Nullable R	proceed()	Proceeds with the invocation.
R	proceed(Interceptor from)	Proceeds with the invocation using the given interceptor as a position to start from.
String	toString()

Methods inherited from class InterceptorChain

getAnnotationMetadata, getArguments, getTarget, resolveAroundInterceptors, resolveAroundInterceptors, resolveAroundInterceptors, resolveIntroductionInterceptors, resolveIntroductionInterceptors, resolveIntroductionInterceptors

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface AnnotatedElement

isDeclaredNonNull, isDeclaredNullable, isNonNull, isNullable

Methods inherited from interface AnnotationMetadata

enumValuesSet, enumValuesSet, getValues, hasDeclaredStereotype, hasStereotypeNonRepeating, isAnnotationPresent, isDeclaredAnnotationPresent

Methods inherited from interface AnnotationMetadataDelegate

booleanValue, booleanValue, booleanValue, booleanValue, classValue, classValue, classValue, classValue, classValues, classValues, classValues, classValues, copyAnnotationMetadata, doubleValue, doubleValue, doubleValue, enumValue, enumValue, enumValue, enumValue, enumValues, enumValues, enumValues, enumValues, findAnnotation, findAnnotation, findDeclaredAnnotation, findDeclaredAnnotation, findRepeatableAnnotation, findRepeatableAnnotation, getAnnotation, getAnnotation, getAnnotationNameByStereotype, getAnnotationNameByStereotype, getAnnotationNames, getAnnotationNamesByStereotype, getAnnotationNamesByStereotype, getAnnotationType, getAnnotationType, getAnnotationTypeByStereotype, getAnnotationTypeByStereotype, getAnnotationTypesByStereotype, getAnnotationTypesByStereotype, getAnnotationTypesByStereotype, getAnnotationValuesByName, getAnnotationValuesByStereotype, getAnnotationValuesByType, getDeclaredAnnotation, getDeclaredAnnotation, getDeclaredAnnotationNameByStereotype, getDeclaredAnnotationNames, getDeclaredAnnotationNamesByStereotype, getDeclaredAnnotationTypeByStereotype, getDeclaredAnnotationTypeByStereotype, getDeclaredAnnotationValuesByName, getDeclaredAnnotationValuesByType, getDeclaredMetadata, getDeclaredStereotypeAnnotationNames, getDefaultValue, getDefaultValue, getDefaultValue, getDefaultValue, getDefaultValues, getStereotypeAnnotationNames, getTargetAnnotationMetadata, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValues, getValues, hasAnnotation, hasAnnotation, hasDeclaredAnnotation, hasDeclaredAnnotation, hasDeclaredStereotype, hasDeclaredStereotype, hasDeclaredStereotype, hasEvaluatedExpressions, hasPropertyExpressions, hasSimpleAnnotation, hasSimpleDeclaredAnnotation, hasStereotype, hasStereotype, hasStereotype, hasStereotype, intValue, intValue, intValue, isAnnotationPresent, isDeclaredAnnotationPresent, isEmpty, isFalse, isFalse, isPresent, isPresent, isRepeatableAnnotation, isRepeatableAnnotation, isTrue, isTrue, longValue, longValue, stringValue, stringValue, stringValue, stringValue, stringValues, stringValues, stringValues, stringValues, synthesize, synthesize, synthesizeAll, synthesizeAnnotationsByType, synthesizeDeclared, synthesizeDeclared, synthesizeDeclared, synthesizeDeclaredAnnotationsByType

Methods inherited from interface AnnotationMetadataProvider

getAnnotationMetadata

Methods inherited from interface AttributeHolder

getAttribute, getAttribute

Methods inherited from interface Executable

getArguments

Methods inherited from interface ExecutableMethod

getDescription, getDescription

Methods inherited from interface InvocationContext

getParameters, getParameterValueMap, getParameterValues, getTarget, proceed, setAttribute

Methods inherited from interface MethodReference

getArgumentNames, getArguments, getName

Methods inherited from interface MutableAttributeHolder

getAttributes, removeAttribute

Field Details

LOG

protected static final org.slf4j.Logger LOG

Used by subclasses!

interceptors

protected final Interceptor<T,R>[] interceptors

originalParameters

protected final @Nullable Object[] originalParameters

interceptorCount

protected final int interceptorCount

attributes

protected volatile @Nullable MutableConvertibleValues<Object> attributes

index

protected int index

parameters

protected volatile @Nullable Map<String, MutableArgumentValue<?>> parameters

Constructor Details

MethodInterceptorChain

public MethodInterceptorChain(Interceptor<T,R>[] interceptors,
 T target,
 ExecutableMethod<T,R> executionHandle)

Constructor for empty parameters.

Parameters:

interceptors - array of interceptors

target - target

executionHandle - executionHandle

MethodInterceptorChain

public MethodInterceptorChain(Interceptor<T,R>[] interceptors,
 T target,
 ExecutableMethod<T,R> executionHandle,
 @Nullable InterceptorKind kind)

Constructor for empty parameters.

Parameters:

interceptors - array of interceptors

target - target

executionHandle - executionHandle

kind - The interception kind

MethodInterceptorChain

public MethodInterceptorChain(Interceptor<T,R>[] interceptors,
 T target,
 ExecutableMethod<T,R> executionHandle,
 @Nullable Object... originalParameters)

Constructor.

Parameters:

interceptors - array of interceptors

target - target

executionHandle - executionHandle

originalParameters - originalParameters

Method Details

getKind

public InterceptorKind getKind()

Specified by:

getKind in interface InvocationContext<T,R>

Returns:

An enum representing the kind of interception that is occurring.

invoke

public @Nullable R invoke(T instance,
 @Nullable Object... arguments)

Description copied from interface: Executable

Invokes the method.

Specified by:

invoke in interface Executable<T,R>

Overrides:

invoke in class InterceptorChain<T,R>

Parameters:

instance - The instance. Nullable only if it's a static method call.

arguments - The arguments

Returns:

The result

isSuspend

public boolean isSuspend()

Description copied from interface: ExecutableMethod

Defines whether the method is Kotlin suspend function.

Specified by:

isSuspend in interface ExecutableMethod<T,R>

Specified by:

isSuspend in interface MethodInvocationContext<T,R>

Returns:

Is the method Kotlin suspend function.

isAbstract

public boolean isAbstract()

Description copied from interface: ExecutableMethod

Defines whether the method is abstract.

Specified by:

isAbstract in interface ExecutableMethod<T,R>

Specified by:

isAbstract in interface MethodInvocationContext<T,R>

Returns:

Is the method abstract.

proceed

public @Nullable R proceed()
                    throws RuntimeException

Description copied from interface: InvocationContext

Proceeds with the invocation. If this is the last interceptor in the chain then the final implementation method is invoked

Specified by:

proceed in interface InvocationContext<T,R>

Overrides:

proceed in class InterceptorChain<T,R>

Returns:

The return value of the method

Throws:

RuntimeException - chain may throw RTE

getMethodName

public String getMethodName()

Specified by:

getMethodName in interface MethodReference<T,R>

Returns:

The name of the method

getArgumentTypes

public Class<?>[] getArgumentTypes()

Specified by:

getArgumentTypes in interface MethodReference<T,R>

Returns:

The argument types

getTargetMethod

public Method getTargetMethod()

Specified by:

getTargetMethod in interface MethodReference<T,R>

Returns:

The target method

getReturnType

public ReturnType<R> getReturnType()

Specified by:

getReturnType in interface MethodReference<T,R>

Returns:

Return the return type

getDeclaringType

public Class<T> getDeclaringType()

Specified by:

getDeclaringType in interface Executable<T,R>

Specified by:

getDeclaringType in interface InvocationContext<T,R>

Specified by:

getDeclaringType in interface MethodInvocationContext<T,R>

Specified by:

getDeclaringType in interface MethodReference<T,R>

Returns:

The declaring type

toString

public String toString()

Overrides:

toString in class Object

getExecutableMethod

public ExecutableMethod<T,R> getExecutableMethod()

Description copied from interface: MethodInvocationContext

The underlying ExecutableMethod reference.

Specified by:

getExecutableMethod in interface MethodInvocationContext<T,R>

Returns:

The underlying method reference.

initialize

@Internal
public static <T1> @Nullable T1 initialize(BeanResolutionContext resolutionContext,
 BeanContext beanContext,
 BeanDefinition<T1> definition,
 ExecutableMethod<T1,T1> postConstructMethod,
 T1 bean)

Internal method that handles the logic for executing InterceptorKind.POST_CONSTRUCT interception.

Superseded by initialize(BeanResolutionContext, BeanContext, BeanDefinition, ExecutableMethod, Object, Collection), which is what the framework calls now so that post-construct interception can reuse the interceptors already resolved while the bean was constructed. This form resolves interceptors by binding, and nothing in the framework or in currently generated code calls it. It is kept because it is part of the generated-code surface: bean definitions compiled by earlier versions call it directly.

Type Parameters:

T1 - The bean type

Parameters:

resolutionContext - The resolution context

beanContext - The bean context

definition - The definition

postConstructMethod - The post construct method

bean - The bean

Returns:

the bean instance

Since:

3.0.0

initialize

@Internal
public static <T1> @Nullable T1 initialize(BeanResolutionContext resolutionContext,
 BeanContext beanContext,
 BeanDefinition<T1> definition,
 ExecutableMethod<T1,T1> postConstructMethod,
 T1 bean,
 @Nullable Collection<BeanRegistration<Interceptor<?,?>>> interceptors)

Variant of initialize(BeanResolutionContext, BeanContext, BeanDefinition, ExecutableMethod, Object) that reuses registrations already resolved for this bean.

Called for a bean whose interceptors were resolved once while it was constructed, so that a @Prototype interceptor which ran the constructor also runs @PostConstruct. Passing null resolves interceptors by binding, which is what the five-argument form does and what generated code from earlier versions continues to do.

Type Parameters:

T1 - The bean type

Parameters:

resolutionContext - The resolution context

beanContext - The bean context

definition - The definition

postConstructMethod - The post construct method

bean - The bean

interceptors - Registrations resolved for this bean, or null to resolve them

Returns:

the bean instance

Since:

5.2.0

dispose

@Internal
public static <T1> @Nullable T1 dispose(BeanResolutionContext resolutionContext,
 BeanContext beanContext,
 BeanDefinition<T1> definition,
 ExecutableMethod<T1,T1> preDestroyMethod,
 T1 bean)

Internal method that handles the logic for executing InterceptorKind.PRE_DESTROY interception.

Resolves interceptors by binding. Unlike post-construct, destruction has nothing resolved in advance to hand over, because it runs with a fresh resolution context, so this remains the form the framework calls; the overload taking registrations exists for a caller that does hold them.

Type Parameters:

T1 - The bean type

Parameters:

resolutionContext - The resolution context

beanContext - The bean context

definition - The definition

preDestroyMethod - The pre destroy method

bean - The bean

Returns:

the bean instance

Since:

3.0.0

dispose

@Internal
public static <T1> @Nullable T1 dispose(BeanResolutionContext resolutionContext,
 BeanContext beanContext,
 BeanDefinition<T1> definition,
 ExecutableMethod<T1,T1> preDestroyMethod,
 T1 bean,
 @Nullable Collection<BeanRegistration<Interceptor<?,?>>> interceptors)

Variant of dispose(BeanResolutionContext, BeanContext, BeanDefinition, ExecutableMethod, Object) that reuses registrations already resolved for this bean.

Nothing supplies registrations here today: destruction runs with a fresh resolution context, so a bean reaches its interceptors either through the field on its proxy or through the registrations the container passes to the dispose call. The parameter exists so a caller that does hold them can hand them over.

Type Parameters:

T1 - The bean type

Parameters:

resolutionContext - The resolution context

beanContext - The bean context

definition - The definition

preDestroyMethod - The pre destroy method

bean - The bean

interceptors - Registrations resolved for this bean, or null to resolve them

Returns:

the bean instance

Since:

5.2.0

getParameterValues

public @Nullable Object[] getParameterValues()

Description copied from interface: InvocationContext

Returns the current state of the parameters as an array by parameter index. Note that mutations to the array have no effect. If you wish to mutate the parameters use InvocationContext.getParameters() and the MutableArgumentValue interface instead

Specified by:

getParameterValues in interface InvocationContext<B,R>

Returns:

The bound ArgumentValue instances

getAttributes

public MutableConvertibleValues<Object> getAttributes()

Description copied from interface: MutableAttributeHolder

Overrides the default AttributeHolder.getAttributes() method to return a mutable object.

Specified by:

getAttributes in interface AttributeHolder

Specified by:

getAttributes in interface MutableAttributeHolder

Returns:

The mutable attributes

getParameters

public Map<String, MutableArgumentValue<?>> getParameters()

Description copied from interface: InvocationContext

Returns the current parameters as a map of mutable argument values. This method allows mutation of the argument values and is generally more expensive than using InvocationContext.getParameterValues() and Executable.getArguments() directly, hence should be used with care.

Specified by:

getParameters in interface InvocationContext<B,R>

Returns:

The bound ArgumentValue instances

proceed

public R proceed(Interceptor from)
          throws RuntimeException

Description copied from interface: InvocationContext

Proceeds with the invocation using the given interceptor as a position to start from. Mainly useful for Introduction advise where you want to invoke the target multiple times or where you want to repeat the entire chain.

Specified by:

proceed in interface InvocationContext<B,R>

Parameters:

from - The interceptor to start from (note: will not be included in the execution)

Returns:

The return value of the method

Throws:

RuntimeException - chain may throw RTE