io.micronaut.aop.chain

Class ConstructorInterceptorChain<T>

java.lang.Object

io.micronaut.aop.chain.ConstructorInterceptorChain<T>

Type Parameters:

T - The bean type

All Implemented Interfaces:

ConstructorInvocationContext<T>, InvocationContext<T,T>, AnnotationMetadata, AnnotationMetadataDelegate, AnnotationMetadataProvider, AnnotationSource, AttributeHolder, MutableAttributeHolder, Executable<T,T>

@Internal
public final class ConstructorInterceptorChain<T>
extends java.lang.Object
implements ConstructorInvocationContext<T>

Implementation of InvocationContext for constructor interception.

Since:

3.0.0

Author:

graemerocher

Field Summary

Fields

Modifier and Type	Field and Description
protected MutableConvertibleValues<java.lang.Object>	attributes
protected int	index
protected int	interceptorCount
protected Interceptor<B,R>[]	interceptors
protected static org.slf4j.Logger	LOG
protected java.lang.Object[]	originalParameters
protected java.util.Map<java.lang.String,MutableArgumentValue<?>>	parameters

Fields inherited from interface io.micronaut.core.annotation.AnnotationMetadata

CLASS_NAME_SUFFIX, EMPTY_METADATA, VALUE_MEMBER

Fields inherited from interface io.micronaut.core.annotation.AnnotationSource

EMPTY

Constructor Summary

Constructors

Constructor and Description
ConstructorInterceptorChain(BeanConstructor<T> beanConstructor, Interceptor<T,T>[] interceptors, java.lang.Object... originalParameters) Default constructor.
ConstructorInterceptorChain(BeanDefinition<T> beanDefinition, BeanConstructor<T> beanConstructor, Interceptor<T,T>[] interceptors, java.lang.Object... originalParameters) Default constructor.

Method Summary

Modifier and Type	Method and Description
Argument<?>[]	getArguments() The required argument types.
MutableConvertibleValues<java.lang.Object>	getAttributes() Overrides the default AttributeHolder.getAttributes() method to return a mutable object.
BeanConstructor<T>	getConstructor()
InterceptorKind	getKind()
java.util.Map<java.lang.String,MutableArgumentValue<?>>	getParameters() Returns the current parameters as a map of mutable argument values.
java.lang.Object[]	getParameterValues() Returns the current state of the parameters as an array by parameter index.
T	getTarget()
static <T1> T1	instantiate(BeanResolutionContext resolutionContext, BeanContext beanContext, java.util.List<BeanRegistration<Interceptor<T1,T1>>> interceptors, BeanDefinition<T1> definition, BeanConstructor<T1> constructor, java.lang.Object... parameters) Internal methods that handles the logic of instantiating a bean that has constructor interception applied.
T	invoke(T instance, java.lang.Object... arguments) Invokes the method.
T	proceed() Proceeds with the invocation.
R	proceed(Interceptor from) Proceeds with the invocation using the given interceptor as a position to start from.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.micronaut.aop.ConstructorInvocationContext

getDeclaringType, proceed

Methods inherited from interface io.micronaut.aop.InvocationContext

getParameters, getParameterValueMap, getParameterValues, setAttribute

Methods inherited from interface io.micronaut.core.annotation.AnnotationMetadataDelegate

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

Methods inherited from interface io.micronaut.core.annotation.AnnotationMetadataProvider

getAnnotationMetadata

Methods inherited from interface io.micronaut.core.annotation.AnnotationMetadata

getValues, hasDeclaredStereotype, isAnnotationPresent, isDeclaredAnnotationPresent

Methods inherited from interface io.micronaut.core.attr.MutableAttributeHolder

getAttributes, removeAttribute

Methods inherited from interface io.micronaut.core.attr.AttributeHolder

getAttribute, getAttribute

Field Detail

LOG

protected static final org.slf4j.Logger LOG

interceptors

protected final Interceptor<B,R>[] interceptors

originalParameters

protected final java.lang.Object[] originalParameters

interceptorCount

protected final int interceptorCount

attributes

protected MutableConvertibleValues<java.lang.Object> attributes

index

protected int index

parameters

protected java.util.Map<java.lang.String,MutableArgumentValue<?>> parameters

Constructor Detail

ConstructorInterceptorChain

public ConstructorInterceptorChain(@NonNull
                                   BeanConstructor<T> beanConstructor,
                                   @NonNull
                                   Interceptor<T,T>[] interceptors,
                                   java.lang.Object... originalParameters)

Default constructor.

Parameters:

beanConstructor - The bean constructor

interceptors - The method interceptors to be passed to the final object to be constructed

originalParameters - The parameters

ConstructorInterceptorChain

public ConstructorInterceptorChain(@NonNull
                                   BeanDefinition<T> beanDefinition,
                                   @NonNull
                                   BeanConstructor<T> beanConstructor,
                                   @NonNull
                                   Interceptor<T,T>[] interceptors,
                                   java.lang.Object... originalParameters)

Default constructor.

Parameters:

beanDefinition - The bean constructor

beanConstructor - The bean constructor

interceptors - The interceptors

originalParameters - The parameters

Method Detail

getKind

@NonNull
public InterceptorKind getKind()

Specified by:

getKind in interface InvocationContext<T,T>

Returns:

An enum representing the kind of interception that is occurring.

getTarget

public T getTarget()

Specified by:

getTarget in interface InvocationContext<T,T>

Returns:

The target object

proceed

public T proceed()
          throws java.lang.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 ConstructorInvocationContext<T>

Specified by:

proceed in interface InvocationContext<T,T>

Returns:

The return value of the method

Throws:

java.lang.RuntimeException - chain may throw RTE

getArguments

@NonNull
public Argument<?>[] getArguments()

Description copied from interface: Executable

The required argument types.

Specified by:

getArguments in interface Executable<T,T>

Returns:

The arguments

invoke

public T invoke(T instance,
                java.lang.Object... arguments)

Description copied from interface: Executable

Invokes the method.

Specified by:

invoke in interface Executable<T,T>

Parameters:

instance - The instance

arguments - The arguments

Returns:

The result

getConstructor

@NonNull
public BeanConstructor<T> getConstructor()

Specified by:

getConstructor in interface ConstructorInvocationContext<T>

Returns:

The bean type.

instantiate

@Internal
 @NonNull
public static <T1> T1 instantiate(@NonNull
                                                      BeanResolutionContext resolutionContext,
                                                      @NonNull
                                                      BeanContext beanContext,
                                                      @Nullable
                                                      java.util.List<BeanRegistration<Interceptor<T1,T1>>> interceptors,
                                                      @NonNull
                                                      BeanDefinition<T1> definition,
                                                      @NonNull
                                                      BeanConstructor<T1> constructor,
                                                      @NonNull
                                                      java.lang.Object... parameters)

Internal methods that handles the logic of instantiating a bean that has constructor interception applied.

Type Parameters:

T1 - The bean type

Parameters:

resolutionContext - The resolution context

beanContext - The bean context

interceptors - The interceptors. Can be null and if so should be resolved from the context.

definition - The definition

constructor - The bean constructor

parameters - Th resolved parameters

Returns:

The instantiated bean

Since:

3.0.0

getParameterValues

@NonNull
public java.lang.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

@NonNull
public MutableConvertibleValues<java.lang.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

@NonNull
public java.util.Map<java.lang.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(@NonNull
                 Interceptor from)
          throws java.lang.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:

java.lang.RuntimeException - chain may throw RTE