Class AbstractExecutableMethod

java.lang.Object

io.micronaut.context.AbstractExecutableMethod

All Implemented Interfaces:

EnvironmentConfigurable, AnnotatedElement, AnnotationMetadata, AnnotationMetadataDelegate, AnnotationMetadataProvider, AnnotationSource, Described, Named, Executable, UnsafeExecutable, ExecutableMethod, MethodReference

@Internal
public abstract class AbstractExecutableMethod
extends Object
implements UnsafeExecutable, ExecutableMethod, EnvironmentConfigurable

Abstract base class for generated ExecutableMethod classes to implement. The generated classes should implement the Executable.invoke(Object, Object...) method at compile time providing direct dispatch of the target method

Since:

1.0

Author:

Graeme Rocher

Field Summary

Fields

Modifier and Type	Field	Description
protected final Class<?>[]	argTypes
protected final Class<?>	declaringType
protected final String	methodName

Fields inherited from interface AnnotationMetadata

CLASS_NAME_SUFFIX, EMPTY_METADATA, VALUE_MEMBER

Fields inherited from interface AnnotationSource

EMPTY

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractExecutableMethod(Class<?> declaringType, String methodName)
protected	AbstractExecutableMethod(Class<?> declaringType, String methodName, Argument genericReturnType)
protected	AbstractExecutableMethod(Class<?> declaringType, String methodName, Argument genericReturnType, Argument... arguments)

Method Summary

Modifier and Type	Method	Description
void	configure(Environment environment)	Configure the component for the given environment.
boolean	equals(Object o)
AnnotationMetadata	getAnnotationMetadata()	Supplies the metadata.
Argument<?>[]	getArguments()	The required argument types.
Class<?>[]	getArgumentTypes()
Class<?>	getDeclaringType()
String	getMethodName()
ReturnType	getReturnType()
final Method	getTargetMethod()	Soft resolves the target Method avoiding reflection until as late as possible.
int	hashCode()
boolean	hasPropertyExpressions()	Does the metadata contain any property expressions like ${foo.bar}.
final @Nullable Object	invoke(Object instance, @Nullable Object... arguments)	Invokes the method.
protected abstract @Nullable Object	invokeInternal(Object instance, @Nullable Object[] arguments)
@Nullable Object	invokeUnsafe(Object instance, @Nullable Object... arguments)	Invokes the method without the arguments' validation.
protected AnnotationMetadata	resolveAnnotationMetadata()	Resolves the annotation metadata for this method.
protected Method	resolveTargetMethod()	Resolves the target method.
String	toString()

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface AnnotatedElement

isDeclaredNonNull, isDeclaredNullable, isNonNull, isNullable

Methods inherited from interface AnnotationMetadata

enumValuesSet, enumValuesSet, getValues, hasDeclaredStereotype, hasEvaluatedExpressions, 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, 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 Executable

getArguments

Methods inherited from interface ExecutableMethod

getDescription, getDescription, isAbstract, isSuspend

Methods inherited from interface MethodReference

getArgumentNames, getArguments, getName, getTargetMethod

Field Details

declaringType

protected final Class<?> declaringType

methodName

protected final String methodName

argTypes

protected final Class<?>[] argTypes

Constructor Details

AbstractExecutableMethod

protected AbstractExecutableMethod(Class<?> declaringType,
 String methodName,
 Argument genericReturnType,
 Argument... arguments)

Parameters:

declaringType - The declaring type

methodName - The method name

genericReturnType - The generic return type

arguments - The arguments

AbstractExecutableMethod

protected AbstractExecutableMethod(Class<?> declaringType,
 String methodName,
 Argument genericReturnType)

Parameters:

declaringType - The declaring type

methodName - The method name

genericReturnType - The generic return type

AbstractExecutableMethod

protected AbstractExecutableMethod(Class<?> declaringType,
 String methodName)

Parameters:

declaringType - The declaring type

methodName - The method name

Method Details

hasPropertyExpressions

public boolean hasPropertyExpressions()

Description copied from interface: AnnotationMetadata

Does the metadata contain any property expressions like ${foo.bar}. Note this by default returns true as previous versions of Micronaut must assume metadata is present. The compilation time this is computed in order to decide whether to instrument annotation metadata with environment specific logic.

Specified by:

hasPropertyExpressions in interface AnnotationMetadata

Specified by:

hasPropertyExpressions in interface AnnotationMetadataDelegate

Specified by:

hasPropertyExpressions in interface EnvironmentConfigurable

Returns:

True if property expressions are present

getAnnotationMetadata

public AnnotationMetadata getAnnotationMetadata()

Description copied from interface: AnnotationMetadataProvider

Supplies the metadata. Defaults to AnnotationMetadata.EMPTY_METADATA.

Specified by:

getAnnotationMetadata in interface AnnotationMetadataProvider

Returns:

The AnnotationMetadata

configure

public void configure(Environment environment)

Description copied from interface: EnvironmentConfigurable

Configure the component for the given environment.

Specified by:

configure in interface EnvironmentConfigurable

Parameters:

environment - The environment

equals

public boolean equals(Object o)

hashCode

public int hashCode()

toString

public String toString()

Overrides:

toString in class Object

getReturnType

public ReturnType getReturnType()

Specified by:

getReturnType in interface MethodReference

Returns:

Return the return type

getArgumentTypes

public Class<?>[] getArgumentTypes()

Specified by:

getArgumentTypes in interface MethodReference

Returns:

The argument types

getDeclaringType

public Class<?> getDeclaringType()

Specified by:

getDeclaringType in interface Executable

Specified by:

getDeclaringType in interface MethodReference

Returns:

The declaring type

getMethodName

public String getMethodName()

Specified by:

getMethodName in interface MethodReference

Returns:

The name of the method

invoke

public final @Nullable Object invoke(Object instance,
 @Nullable Object... arguments)

Description copied from interface: Executable

Invokes the method.

Specified by:

invoke in interface Executable

Parameters:

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

arguments - The arguments

Returns:

The result

invokeUnsafe

public @Nullable Object invokeUnsafe(Object instance,
 @Nullable Object... arguments)

Description copied from interface: UnsafeExecutable

Invokes the method without the arguments' validation.

Specified by:

invokeUnsafe in interface UnsafeExecutable

Parameters:

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

arguments - The arguments

Returns:

The result

invokeInternal

protected abstract @Nullable Object invokeInternal(Object instance,
 @Nullable Object[] arguments)

Parameters:

instance - The instance

arguments - The arguments

Returns:

The result

resolveAnnotationMetadata

protected AnnotationMetadata resolveAnnotationMetadata()

Resolves the annotation metadata for this method. Subclasses

Returns:

The AnnotationMetadata

getArguments

public Argument<?>[] getArguments()

Description copied from interface: Executable

The required argument types.

Specified by:

getArguments in interface Executable

Returns:

The arguments

getTargetMethod

public final Method getTargetMethod()

Soft resolves the target Method avoiding reflection until as late as possible.

Returns:

The method

Throws:

NoSuchMethodError - if the method doesn't exist

resolveTargetMethod

protected Method resolveTargetMethod()

Resolves the target method.

Returns:

The target method