AbstractBeanDefinition (micronaut 3.9.3 API)

java.lang.Object
- io.micronaut.context.AbstractBeanDefinition<T>

Type Parameters:

T - The Bean definition type

All Implemented Interfaces:

EnvironmentConfigurable, AnnotationMetadata, AnnotationMetadataDelegate, AnnotationMetadataProvider, AnnotationSource, Named, ArgumentCoercible<T>, BeanContextConditional, BeanDefinition<T>, BeanType<T>

Direct Known Subclasses:

AbstractParametrizedBeanDefinition
```
@Internal
public class AbstractBeanDefinition<T>
extends Object
implements BeanDefinition<T>, EnvironmentConfigurable
```
Default implementation of the BeanDefinition interface. This class is generally not used directly in user code. Instead a build time tool does analysis of source code and dynamically produces subclasses of this class containing information about the available injection points for a given class.

For technical reasons the class has to be marked as public, but is regarded as internal and should be used by compiler tools and plugins (such as AST transformation frameworks)

The BeanDefinitionWriter class can be used to produce bean definitions at compile or runtime

Since:

1.0

Author:

Graeme Rocher

See Also:

BeanDefinitionWriter

Field Summary

Fields
Modifier and Type	Field and Description
`protected Map<io.micronaut.context.AbstractBeanDefinition.MethodKey,ExecutableMethod<T,?>>`	`executableMethodMap`
`protected List<FieldInjectionPoint<T,?>>`	`fieldInjectionPoints`
`protected List<MethodInjectionPoint<T,?>>`	`methodInjectionPoints`
`protected List<MethodInjectionPoint<T,?>>`	`postConstructMethods`
`protected List<MethodInjectionPoint<T,?>>`	`preDestroyMethods`

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
Modifier	Constructor and Description
`protected`	`AbstractBeanDefinition(Class<T> type, AnnotationMetadata constructorAnnotationMetadata, boolean requiresReflection, Argument... arguments)` Constructs a bean for the given type.
`protected`	`AbstractBeanDefinition(Class<T> producedType, Class<?> declaringType, String fieldName, AnnotationMetadata fieldMetadata, boolean isFinal)` Constructs a bean definition that is produced from a method call on another type (factory bean).
`protected`	`AbstractBeanDefinition(Class<T> producedType, Class<?> declaringType, String methodName, AnnotationMetadata methodMetadata, boolean requiresReflection, Argument<?>... arguments)` Constructs a bean definition that is produced from a method call on another type (factory bean).

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected AbstractBeanDefinition<T>`	`addExecutableMethod(ExecutableMethod<T,?> executableMethod)` Adds a new `ExecutableMethod`.
`protected AbstractBeanDefinition`	`addInjectionPoint(Class declaringType, Class fieldType, String field, AnnotationMetadata annotationMetadata, Argument[] typeArguments, boolean requiresReflection)` Adds an injection point for a field.
`protected AbstractBeanDefinition`	`addInjectionPoint(Class declaringType, String method, Argument[] arguments, AnnotationMetadata annotationMetadata, boolean requiresReflection)` Adds an injection point for a method that cannot be resolved at runtime, but a compile time produced injection point exists.
`protected AbstractBeanDefinition`	`addPostConstruct(Class declaringType, String method, Argument[] arguments, AnnotationMetadata annotationMetadata, boolean requiresReflection)` Adds a post construct method definition.
`protected AbstractBeanDefinition`	`addPreDestroy(Class declaringType, String method, Argument[] arguments, AnnotationMetadata annotationMetadata, boolean requiresReflection)` Adds a pre destroy method definition.
`void`	`configure(Environment environment)` Configures the bean for the given `BeanContext`.
`protected boolean`	`containsProperties(BeanResolutionContext resolutionContext, BeanContext context)` If this bean is a `ConfigurationProperties` bean return whether any properties for it are configured within the context.
`protected boolean`	`containsProperties(BeanResolutionContext resolutionContext, BeanContext context, String subProperty)` If this bean is a `ConfigurationProperties` bean return whether any properties for it are configured within the context.
`protected boolean`	`containsValueForField(BeanResolutionContext resolutionContext, BeanContext context, int fieldIndex)` Obtains a value for the given field argument.
`protected boolean`	`containsValueForMethodArgument(BeanResolutionContext resolutionContext, BeanContext context, int methodIndex, int argIndex)` Obtains a value for the given method argument.
`boolean`	`equals(Object o)`
`protected Optional`	`findBeanForConstructorArgument(BeanResolutionContext resolutionContext, BeanContext context, ConstructorInjectionPoint<T> constructorInjectionPoint, Argument argument)` Obtains all bean definitions for a constructor argument at the given index
`protected Optional`	`findBeanForField(BeanResolutionContext resolutionContext, BeanContext context, FieldInjectionPoint injectionPoint)` Obtains a an optional for the field at the given index and the argument at the given index
`protected Optional`	`findBeanForMethodArgument(BeanResolutionContext resolutionContext, BeanContext context, MethodInjectionPoint injectionPoint, Argument argument)` Obtains an optional bean for the method at the given index and the argument at the given index
`<R> Optional<ExecutableMethod<T,R>>`	`findMethod(String name, Class<?>... argumentTypes)` Finds a single `ExecutableMethod` for the given name and argument types.
`Stream<ExecutableMethod<T,?>>`	`findPossibleMethods(String name)` Finds possible methods for the given method name.
`AnnotationMetadata`	`getAnnotationMetadata()` Supplies the metadata.
`protected Object`	`getBeanForConstructorArgument(BeanResolutionContext resolutionContext, BeanContext context, int argIndex)` Obtains a bean definition for a constructor at the given index
`protected Object`	`getBeanForField(BeanResolutionContext resolutionContext, BeanContext context, FieldInjectionPoint injectionPoint)` Resolves a bean for the given `FieldInjectionPoint`.
`protected Object`	`getBeanForField(BeanResolutionContext resolutionContext, BeanContext context, int fieldIndex)` Obtains a bean definition for the field at the given index and the argument at the given index
`protected Object`	`getBeanForMethodArgument(BeanResolutionContext resolutionContext, BeanContext context, int methodIndex, int argIndex)` Obtains a bean definition for the method at the given index and the argument at the given index
`protected BeanRegistration<?>`	`getBeanRegistrationForConstructorArgument(BeanResolutionContext resolutionContext, BeanContext context, int argIndex)` Obtains a bean registration for a method injection point.
`protected BeanRegistration<?>`	`getBeanRegistrationForField(BeanResolutionContext resolutionContext, BeanContext context, int fieldIndex)` Obtains a bean registration for a field injection point.
`protected BeanRegistration<?>`	`getBeanRegistrationForMethodArgument(BeanResolutionContext resolutionContext, BeanContext context, int methodIndex, int argIndex)` Obtains a bean registration for a method injection point.
`protected Object`	`getBeanRegistrationsForConstructorArgument(BeanResolutionContext resolutionContext, BeanContext context, int argumentIndex)` Obtains all bean definitions for a constructor argument at the given index
`protected Object`	`getBeanRegistrationsForField(BeanResolutionContext resolutionContext, BeanContext context, int fieldIndex)` Obtains all bean definitions for a field injection point.
`protected Object`	`getBeanRegistrationsForMethodArgument(BeanResolutionContext resolutionContext, BeanContext context, int methodIndex, int argIndex)` Obtains all bean definitions for a method injection point.
`protected Collection`	`getBeansOfTypeForConstructorArgument(BeanResolutionContext resolutionContext, BeanContext context, ConstructorInjectionPoint<T> constructorInjectionPoint, Argument argument)` Obtains all bean definitions for a constructor argument at the given index.
`protected Object`	`getBeansOfTypeForConstructorArgument(BeanResolutionContext resolutionContext, BeanContext context, int argumentIndex)` Obtains all bean definitions for a constructor argument at the given index.
`protected Collection`	`getBeansOfTypeForField(BeanResolutionContext resolutionContext, BeanContext context, FieldInjectionPoint injectionPoint)` Obtains a bean definition for the field at the given index and the argument at the given index
`protected Object`	`getBeansOfTypeForField(BeanResolutionContext resolutionContext, BeanContext context, int fieldIndex)` Obtains all bean definitions for the field at the given index.
`protected Object`	`getBeansOfTypeForMethodArgument(BeanResolutionContext resolutionContext, BeanContext context, int methodIndex, int argumentIndex)` Obtains all bean definitions for a constructor argument at the given index.
`protected Collection`	`getBeansOfTypeForMethodArgument(BeanResolutionContext resolutionContext, BeanContext context, MethodInjectionPoint injectionPoint, Argument argument)` Obtains all bean definitions for the method at the given index and the argument at the given index
`Class<T>`	`getBeanType()` Returns the bean type.
`ConstructorInjectionPoint<T>`	`getConstructor()` The single concrete constructor that is an injection point for creating the bean.
`Optional<Argument<?>>`	`getContainerElement()` If `BeanType.isContainerType()` returns true this will return the container element.
`Optional<Class<?>>`	`getDeclaringType()`
`Collection<ExecutableMethod<T,?>>`	`getExecutableMethods()`
`Set<Class<?>>`	`getExposedTypes()` Returns a potentially limited subset of bean types exposed by this bean.
`Collection<FieldInjectionPoint<T,?>>`	`getInjectedFields()` All the fields that require injection.
`Collection<MethodInjectionPoint<T,?>>`	`getInjectedMethods()` All methods that require injection.
`String`	`getName()`
`Collection<MethodInjectionPoint<T,?>>`	`getPostConstructMethods()` All the methods that should be called once the bean has been fully initialized and constructed.
`Collection<MethodInjectionPoint<T,?>>`	`getPreDestroyMethods()` All the methods that should be called when the object is to be destroyed.
`protected Object`	`getProxiedBean(BeanContext beanContext)` Resolves the proxied bean instance for this bean.
`Collection<Class<?>>`	`getRequiredComponents()`
`Optional<Class<? extends Annotation>>`	`getScope()`
`Optional<String>`	`getScopeName()`
`protected Stream`	`getStreamOfTypeForField(BeanResolutionContext resolutionContext, BeanContext context, FieldInjectionPoint injectionPoint)` Obtains a bean definition for the field at the given index and the argument at the given index
`List<Argument<?>>`	`getTypeArguments(String type)` Return the type arguments for the given interface or super type for this bean.
`protected Map<String,Argument<?>[]>`	`getTypeArgumentsMap()` A method that subclasses can override to provide information on type arguments.
`protected Object`	`getValueForConstructorArgument(BeanResolutionContext resolutionContext, BeanContext context, int argIndex)` Obtains a value for a bean definition for a constructor at the given index
`protected Object`	`getValueForField(BeanResolutionContext resolutionContext, BeanContext context, int fieldIndex)` Obtains a value for the given field from the bean context
`protected Object`	`getValueForMethodArgument(BeanResolutionContext resolutionContext, BeanContext context, int methodIndex, int argIndex)` Obtains a value for the given method argument.
`protected <T1> Optional<T1>`	`getValueForPath(BeanResolutionContext resolutionContext, BeanContext context, Argument<T1> propertyType, String... propertyPath)` Resolve a value for the given field of the given type and path.
`protected <T1> Optional<T1>`	`getValueForPath(BeanResolutionContext resolutionContext, BeanContext context, Argument<T1> propertyType, String propertyPath)` Resolve a value for the given field of the given type and path.
`int`	`hashCode()`
`boolean`	`hasPropertyExpressions()` Does the metadata contain any property expressions like `${foo.bar}`.
`T`	`inject(BeanContext context, T bean)` Inject the given bean with the context.
`T`	`inject(BeanResolutionContext resolutionContext, BeanContext context, T bean)` Inject the given bean with the context.
`protected Object`	`injectAnother(BeanResolutionContext resolutionContext, BeanContext context, Object bean)` Inject another bean, for example one created via factory.
`protected Object`	`injectBean(BeanResolutionContext resolutionContext, BeanContext context, Object bean)` The default implementation which provides no injection.
`protected void`	`injectBeanField(BeanResolutionContext resolutionContext, DefaultBeanContext context, int index, Object bean)` Injects the value of a field of a bean that requires reflection.
`protected void`	`injectBeanMethod(BeanResolutionContext resolutionContext, DefaultBeanContext context, int methodIndex, Object bean)` Inject a bean method that requires reflection.
`boolean`	`isAbstract()`
`boolean`	`isEnabled(BeanContext context, BeanResolutionContext resolutionContext)` Return whether this component is enabled for the given context.
`boolean`	`isIterable()`
`boolean`	`isPrimary()`
`boolean`	`isProvided()`
`protected Object`	`postConstruct(BeanResolutionContext resolutionContext, BeanContext context, Object bean)` Default postConstruct hook that only invokes methods that require reflection.
`protected Object`	`preDestroy(BeanResolutionContext resolutionContext, BeanContext context, Object bean)` Default preDestroy hook that only invokes methods that require reflection.
`protected AnnotationMetadata`	`resolveAnnotationMetadata()` Resolves the annotation metadata for this bean.
`protected Stream`	`streamOfTypeForConstructorArgument(BeanResolutionContext resolutionContext, BeanContext context, ConstructorInjectionPoint<T> constructorInjectionPoint, Argument argument)` Obtains all bean definitions for a constructor argument at the given index
`protected Stream`	`streamOfTypeForMethodArgument(BeanResolutionContext resolutionContext, BeanContext context, MethodInjectionPoint injectionPoint, Argument argument)` Obtains all bean definitions for the method at the given index and the argument at the given index
`String`	`toString()`
`protected void`	`warn(String message)` Allows printing warning messages produced by the compiler.
`protected void`	`warnMissingProperty(Class type, String method, String property)` Allows printing warning messages produced by the compiler.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.micronaut.inject.BeanDefinition
asArgument, getDeclaredQualifier, getRequiredMethod, getTypeArguments, getTypeArguments, getTypeParameters, getTypeParameters, isCandidateBean, isProxy, isSingleton, resolveDynamicQualifier

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, findRepeatableAnnotation, findRepeatableAnnotation, getAnnotation, getAnnotation, getAnnotationNameByStereotype, getAnnotationNameByStereotype, getAnnotationNames, getAnnotationNamesByStereotype, getAnnotationNamesByStereotype, getAnnotationType, getAnnotationType, getAnnotationTypeByStereotype, getAnnotationTypeByStereotype, getAnnotationTypesByStereotype, getAnnotationTypesByStereotype, getAnnotationTypesByStereotype, getAnnotationValuesByType, getDeclaredAnnotation, getDeclaredAnnotation, getDeclaredAnnotationNameByStereotype, getDeclaredAnnotationNames, getDeclaredAnnotationNamesByStereotype, getDeclaredAnnotationTypeByStereotype, getDeclaredAnnotationTypeByStereotype, getDeclaredAnnotationValuesByType, getDeclaredMetadata, getDeclaredStereotypeAnnotationNames, getDefaultValue, getDefaultValue, getDefaultValue, getDefaultValue, getDefaultValues, getStereotypeAnnotationNames, 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 io.micronaut.core.annotation.AnnotationMetadata
getAnnotationValuesByName, getAnnotationValuesByStereotype, getDeclaredAnnotationValuesByName, getValues, hasDeclaredStereotype, isAnnotationPresent, isDeclaredAnnotationPresent

Methods inherited from interface io.micronaut.inject.BeanType
isContainerType, requiresMethodProcessing

Methods inherited from interface io.micronaut.inject.BeanContextConditional
isEnabled, isEnabled

Field Detail

methodInjectionPoints

protected final List<MethodInjectionPoint<T,?>> methodInjectionPoints

fieldInjectionPoints

protected final List<FieldInjectionPoint<T,?>> fieldInjectionPoints

postConstructMethods

protected List<MethodInjectionPoint<T,?>> postConstructMethods

preDestroyMethods

protected List<MethodInjectionPoint<T,?>> preDestroyMethods

executableMethodMap

protected Map<io.micronaut.context.AbstractBeanDefinition.MethodKey,ExecutableMethod<T,?>> executableMethodMap

Constructor Detail

AbstractBeanDefinition

@Internal
protected AbstractBeanDefinition(Class<T> producedType,
                                           Class<?> declaringType,
                                           String fieldName,
                                           AnnotationMetadata fieldMetadata,
                                           boolean isFinal)

Constructs a bean definition that is produced from a method call on another type (factory bean).

Parameters:: producedType - The produced type; declaringType - The declaring type of the method; fieldName - The method name; fieldMetadata - The metadata for the method; isFinal - Is the field final
Since:: 3.0

AbstractBeanDefinition

@Internal
protected AbstractBeanDefinition(Class<T> producedType,
                                           Class<?> declaringType,
                                           String methodName,
                                           AnnotationMetadata methodMetadata,
                                           boolean requiresReflection,
                                           Argument<?>... arguments)

Constructs a bean definition that is produced from a method call on another type (factory bean).

Parameters:: producedType - The produced type; declaringType - The declaring type of the method; methodName - The method name; methodMetadata - The metadata for the method; requiresReflection - Whether reflection is required to invoke the method; arguments - The method arguments

AbstractBeanDefinition

@Internal
protected AbstractBeanDefinition(Class<T> type,
                                           AnnotationMetadata constructorAnnotationMetadata,
                                           boolean requiresReflection,
                                           Argument... arguments)

Constructs a bean for the given type.

Parameters:: type - The type; constructorAnnotationMetadata - The annotation metadata for the constructor; requiresReflection - Whether reflection is required; arguments - The constructor arguments used to build the bean

Method Detail

getContainerElement
```
public Optional<Argument<?>> getContainerElement()
```
Description copied from interface: BeanDefinition

If BeanType.isContainerType() returns true this will return the container element.

Specified by:

getContainerElement in interface BeanDefinition<T>

Returns:

The container element.

hasPropertyExpressions
```
public final 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 EnvironmentConfigurable

Specified by:

hasPropertyExpressions in interface AnnotationMetadata

Specified by:

hasPropertyExpressions in interface AnnotationMetadataDelegate

Returns:

True if property expressions are present

getTypeArguments
```
@NonNull
public List<Argument<?>> getTypeArguments(String type)
```
Description copied from interface: BeanDefinition

Return the type arguments for the given interface or super type for this bean.

Specified by:

getTypeArguments in interface BeanDefinition<T>

Parameters:

type - The super class or interface type

Returns:

The type arguments

getAnnotationMetadata
```
@NonNull
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

isAbstract
```
public boolean isAbstract()
```
Specified by:

isAbstract in interface BeanDefinition<T>

Returns:

Whether the bean definition is abstract

isIterable
```
public boolean isIterable()
```
Specified by:

isIterable in interface BeanDefinition<T>

Returns:

Whether the bean declared with EachProperty or EachBean

isPrimary
```
public boolean isPrimary()
```
Specified by:

isPrimary in interface BeanType<T>

Returns:

Whether the bean definition is the Primary

findMethod
```
public <R> Optional<ExecutableMethod<T,R>> findMethod(String name,
                                                      Class<?>... argumentTypes)
```
Description copied from interface: BeanDefinition

Finds a single ExecutableMethod for the given name and argument types.

Specified by:

findMethod in interface BeanDefinition<T>

Type Parameters:

R - The return type

Parameters:

name - The method name

argumentTypes - The argument types

Returns:

An optional ExecutableMethod

findPossibleMethods
```
public Stream<ExecutableMethod<T,?>> findPossibleMethods(String name)
```
Description copied from interface: BeanDefinition

Finds possible methods for the given method name.

Specified by:

findPossibleMethods in interface BeanDefinition<T>

Parameters:

name - The method name

Returns:

The possible methods

equals
```
public boolean equals(Object o)
```
Overrides:

equals in class Object

hashCode
```
public int hashCode()
```
Overrides:

hashCode in class Object

toString
```
public String toString()
```
Overrides:

toString in class Object

isProvided
```
public boolean isProvided()
```
Specified by:

isProvided in interface BeanDefinition<T>

Returns:

Is this definition provided by another bean

See Also:

Provided

getScope
```
public Optional<Class<? extends Annotation>> getScope()
```
Specified by:

getScope in interface BeanDefinition<T>

Returns:

The scope of the bean

getScopeName
```
public Optional<String> getScopeName()
```
Specified by:

getScopeName in interface BeanDefinition<T>

Returns:

The name of the scope

getBeanType
```
public final Class<T> getBeanType()
```
Description copied from interface: BeanType

Returns the bean type.

Specified by:

getBeanType in interface BeanDefinition<T>

Specified by:

getBeanType in interface BeanType<T>

Returns:

The produced bean type

getExposedTypes
```
@NonNull
public final Set<Class<?>> getExposedTypes()
```
Description copied from interface: BeanType

Returns a potentially limited subset of bean types exposed by this bean. The types to be exposed can be defined by the Type annotation.

Specified by:

getExposedTypes in interface BeanType<T>

Returns:

The exposed types

getDeclaringType
```
public final Optional<Class<?>> getDeclaringType()
```
Specified by:

getDeclaringType in interface BeanDefinition<T>

Returns:

The type that declares this definition, null if not applicable.

getConstructor
```
public final ConstructorInjectionPoint<T> getConstructor()
```
Description copied from interface: BeanDefinition

The single concrete constructor that is an injection point for creating the bean.

Specified by:

getConstructor in interface BeanDefinition<T>

Returns:

The constructor injection point

getRequiredComponents
```
public Collection<Class<?>> getRequiredComponents()
```
Specified by:

getRequiredComponents in interface BeanDefinition<T>

Returns:

All required components for this entity definition

getInjectedMethods
```
public final Collection<MethodInjectionPoint<T,?>> getInjectedMethods()
```
Description copied from interface: BeanDefinition

All methods that require injection. This is a subset of all the methods in the class.

Specified by:

getInjectedMethods in interface BeanDefinition<T>

Returns:

The required properties

getInjectedFields
```
public final Collection<FieldInjectionPoint<T,?>> getInjectedFields()
```
Description copied from interface: BeanDefinition

All the fields that require injection.

Specified by:

getInjectedFields in interface BeanDefinition<T>

Returns:

The required fields

getPostConstructMethods
```
public final Collection<MethodInjectionPoint<T,?>> getPostConstructMethods()
```
Description copied from interface: BeanDefinition

All the methods that should be called once the bean has been fully initialized and constructed.

Specified by:

getPostConstructMethods in interface BeanDefinition<T>

Returns:

Methods to call post construct

getPreDestroyMethods
```
public final Collection<MethodInjectionPoint<T,?>> getPreDestroyMethods()
```
Description copied from interface: BeanDefinition

All the methods that should be called when the object is to be destroyed.

Specified by:

getPreDestroyMethods in interface BeanDefinition<T>

Returns:

Methods to call pre-destroy

getName
```
@NonNull
public String getName()
```
Specified by:

getName in interface Named

Specified by:

getName in interface BeanDefinition<T>

Specified by:

getName in interface BeanType<T>

Returns:

The class name

inject
```
public T inject(BeanContext context,
                T bean)
```
Description copied from interface: BeanDefinition

Inject the given bean with the context.

Specified by:

inject in interface BeanDefinition<T>

Parameters:

context - The context

bean - The bean

Returns:

The injected bean

inject
```
public T inject(BeanResolutionContext resolutionContext,
                BeanContext context,
                T bean)
```
Description copied from interface: BeanDefinition

Inject the given bean with the context.

Specified by:

inject in interface BeanDefinition<T>

Parameters:

resolutionContext - the resolution context

context - The context

bean - The bean

Returns:

The injected bean

getExecutableMethods
```
public Collection<ExecutableMethod<T,?>> getExecutableMethods()
```
Specified by:

getExecutableMethods in interface BeanDefinition<T>

Returns:

The ExecutableMethod instances for this definition

configure
```
@Internal
public final void configure(Environment environment)
```
Configures the bean for the given BeanContext. If the context features an Environment this method configures the annotation metadata such that environment aware values are returned.

Specified by:

configure in interface EnvironmentConfigurable

Parameters:

environment - The environment

warn
```
@Internal
protected final void warn(String message)
```
Allows printing warning messages produced by the compiler.

Parameters:

message - The message

warnMissingProperty

@Internal
protected final void warnMissingProperty(Class type,
                                                   String method,
                                                   String property)

Allows printing warning messages produced by the compiler.

Parameters:: type - The type; method - The method; property - The property

getProxiedBean
```
@Internal
protected final Object getProxiedBean(BeanContext beanContext)
```
Resolves the proxied bean instance for this bean.

Parameters:

beanContext - The BeanContext

Returns:

The proxied bean

addExecutableMethod

@Internal
protected final AbstractBeanDefinition<T> addExecutableMethod(ExecutableMethod<T,?> executableMethod)

Adds a new ExecutableMethod.

Parameters:: executableMethod - The method
Returns:: The bean definition

addInjectionPoint

@Internal
protected final AbstractBeanDefinition addInjectionPoint(Class declaringType,
                                                                   Class fieldType,
                                                                   String field,
                                                                   @Nullable
                                                                   AnnotationMetadata annotationMetadata,
                                                                   @Nullable
                                                                   Argument[] typeArguments,
                                                                   boolean requiresReflection)

Adds an injection point for a field. Typically called by a dynamically generated subclass.

Parameters:: declaringType - The declaring type; fieldType - The field type; field - The name of the field; annotationMetadata - The annotation metadata for the field; typeArguments - The arguments; requiresReflection - Whether reflection is required
Returns:: this component definition

addInjectionPoint

@Internal
protected final AbstractBeanDefinition addInjectionPoint(Class declaringType,
                                                                   String method,
                                                                   @Nullable
                                                                   Argument[] arguments,
                                                                   @Nullable
                                                                   AnnotationMetadata annotationMetadata,
                                                                   boolean requiresReflection)

Adds an injection point for a method that cannot be resolved at runtime, but a compile time produced injection point exists. This allows the framework to recover and relay better error messages to the user instead of just NoSuchMethodError.

Parameters:: declaringType - The declaring type; method - The method; arguments - The argument types; annotationMetadata - The annotation metadata; requiresReflection - Whether the method requires reflection to invoke
Returns:: this component definition

addPostConstruct

@Internal
protected final AbstractBeanDefinition addPostConstruct(Class declaringType,
                                                                  String method,
                                                                  @Nullable
                                                                  Argument[] arguments,
                                                                  @Nullable
                                                                  AnnotationMetadata annotationMetadata,
                                                                  boolean requiresReflection)

Adds a post construct method definition.

Parameters:: declaringType - The declaring type; method - The method; arguments - The arguments; annotationMetadata - The annotation metadata; requiresReflection - Whether the method requires reflection
Returns:: This bean definition

addPreDestroy

@Internal
protected final AbstractBeanDefinition addPreDestroy(Class declaringType,
                                                               String method,
                                                               Argument[] arguments,
                                                               AnnotationMetadata annotationMetadata,
                                                               boolean requiresReflection)

Adds a pre destroy method definition.

Parameters:: declaringType - The declaring type; method - The method; arguments - The arguments; annotationMetadata - The annotation metadata; requiresReflection - Whether the method requires reflection
Returns:: This bean definition

injectBean

@Internal
protected Object injectBean(BeanResolutionContext resolutionContext,
                                      BeanContext context,
                                      Object bean)

The default implementation which provides no injection. To be overridden by compile time tooling.

Parameters:: resolutionContext - The resolution context; context - The bean context; bean - The bean
Returns:: The injected bean

injectAnother

@Internal
protected Object injectAnother(BeanResolutionContext resolutionContext,
                                         BeanContext context,
                                         Object bean)

Inject another bean, for example one created via factory.

Parameters:: resolutionContext - The reslution context; context - The context; bean - The bean
Returns:: The bean

postConstruct

@Internal
protected Object postConstruct(BeanResolutionContext resolutionContext,
                                         BeanContext context,
                                         Object bean)

Default postConstruct hook that only invokes methods that require reflection. Generated subclasses should override to call methods that don't require reflection.

Parameters:: resolutionContext - The resolution hook; context - The context; bean - The bean
Returns:: The bean

preDestroy
```
protected Object preDestroy(BeanResolutionContext resolutionContext,
                            BeanContext context,
                            Object bean)
```
Default preDestroy hook that only invokes methods that require reflection. Generated subclasses should override to call methods that don't require reflection.

Parameters:

resolutionContext - The resolution hook

context - The context

bean - The bean

Returns:

The bean

injectBeanMethod

@Internal
protected void injectBeanMethod(BeanResolutionContext resolutionContext,
                                          DefaultBeanContext context,
                                          int methodIndex,
                                          Object bean)

Inject a bean method that requires reflection.

Parameters:: resolutionContext - The resolution context; context - The bean context; methodIndex - The method index; bean - The bean

injectBeanField

@Internal
protected final void injectBeanField(BeanResolutionContext resolutionContext,
                                               DefaultBeanContext context,
                                               int index,
                                               Object bean)

Injects the value of a field of a bean that requires reflection.

Parameters:: resolutionContext - The resolution context; context - The bean context; index - The index of the field; bean - The bean being injected

getValueForMethodArgument

@Internal
protected final Object getValueForMethodArgument(BeanResolutionContext resolutionContext,
                                                           BeanContext context,
                                                           int methodIndex,
                                                           int argIndex)

Obtains a value for the given method argument.

Parameters:: resolutionContext - The resolution context; context - The bean context; methodIndex - The method index; argIndex - The argument index
Returns:: The value

containsValueForMethodArgument

@Internal
protected final boolean containsValueForMethodArgument(BeanResolutionContext resolutionContext,
                                                                 BeanContext context,
                                                                 int methodIndex,
                                                                 int argIndex)

Obtains a value for the given method argument.

Parameters:: resolutionContext - The resolution context; context - The bean context; methodIndex - The method index; argIndex - The argument index
Returns:: The value

getBeanForMethodArgument

@Internal
protected final Object getBeanForMethodArgument(BeanResolutionContext resolutionContext,
                                                          BeanContext context,
                                                          int methodIndex,
                                                          int argIndex)

Obtains a bean definition for the method at the given index and the argument at the given index

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; methodIndex - The method index; argIndex - The argument index
Returns:: The resolved bean

getBeansOfTypeForMethodArgument

@Internal
protected final Collection getBeansOfTypeForMethodArgument(BeanResolutionContext resolutionContext,
                                                                     BeanContext context,
                                                                     MethodInjectionPoint injectionPoint,
                                                                     Argument argument)

Obtains all bean definitions for the method at the given index and the argument at the given index

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; injectionPoint - The method injection point; argument - The argument
Returns:: The resolved bean

findBeanForMethodArgument

@Internal
protected final Optional findBeanForMethodArgument(BeanResolutionContext resolutionContext,
                                                             BeanContext context,
                                                             MethodInjectionPoint injectionPoint,
                                                             Argument argument)

Obtains an optional bean for the method at the given index and the argument at the given index

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; injectionPoint - The method injection point; argument - The argument
Returns:: The resolved bean

streamOfTypeForMethodArgument

@Internal
protected final Stream streamOfTypeForMethodArgument(BeanResolutionContext resolutionContext,
                                                               BeanContext context,
                                                               MethodInjectionPoint injectionPoint,
                                                               Argument argument)

Obtains all bean definitions for the method at the given index and the argument at the given index

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; injectionPoint - The method injection point; argument - The argument
Returns:: The resolved bean

getBeanForConstructorArgument

@Internal
protected final Object getBeanForConstructorArgument(BeanResolutionContext resolutionContext,
                                                               BeanContext context,
                                                               int argIndex)

Obtains a bean definition for a constructor at the given index

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; argIndex - The argument index
Returns:: The resolved bean

getValueForConstructorArgument

@Internal
protected final Object getValueForConstructorArgument(BeanResolutionContext resolutionContext,
                                                                BeanContext context,
                                                                int argIndex)

Obtains a value for a bean definition for a constructor at the given index

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; argIndex - The argument index
Returns:: The resolved bean

getBeansOfTypeForConstructorArgument

@Internal
protected final Collection getBeansOfTypeForConstructorArgument(BeanResolutionContext resolutionContext,
                                                                          BeanContext context,
                                                                          ConstructorInjectionPoint<T> constructorInjectionPoint,
                                                                          Argument argument)

Obtains all bean definitions for a constructor argument at the given index.

Parameters:: resolutionContext - The resolution context; context - The context; constructorInjectionPoint - The constructor injection point; argument - The argument
Returns:: The resolved bean

getBeansOfTypeForConstructorArgument

@Internal
protected final Object getBeansOfTypeForConstructorArgument(BeanResolutionContext resolutionContext,
                                                                      BeanContext context,
                                                                      int argumentIndex)

Obtains all bean definitions for a constructor argument at the given index.

Parameters:: resolutionContext - The resolution context; context - The context; argumentIndex - The argument index
Returns:: The resolved bean

getBeansOfTypeForMethodArgument

@Internal
protected final Object getBeansOfTypeForMethodArgument(BeanResolutionContext resolutionContext,
                                                                 BeanContext context,
                                                                 int methodIndex,
                                                                 int argumentIndex)

Obtains all bean definitions for a constructor argument at the given index.

Parameters:: resolutionContext - The resolution context; context - The context; methodIndex - The method index; argumentIndex - The argument index
Returns:: The resolved bean

getBeansOfTypeForField

@Internal
protected final Object getBeansOfTypeForField(BeanResolutionContext resolutionContext,
                                                        BeanContext context,
                                                        int fieldIndex)

Obtains all bean definitions for the field at the given index.

Parameters:: resolutionContext - The resolution context; context - The context; fieldIndex - The field index
Returns:: The resolved bean

getBeanRegistrationsForConstructorArgument

@Internal
protected final Object getBeanRegistrationsForConstructorArgument(BeanResolutionContext resolutionContext,
                                                                            BeanContext context,
                                                                            int argumentIndex)

Obtains all bean definitions for a constructor argument at the given index

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; argumentIndex - The argument index
Returns:: The resolved bean

getBeanRegistrationForConstructorArgument

@Internal
protected final BeanRegistration<?> getBeanRegistrationForConstructorArgument(BeanResolutionContext resolutionContext,
                                                                                        BeanContext context,
                                                                                        int argIndex)

Obtains a bean registration for a method injection point.

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; argIndex - The arg index
Returns:: The resolved bean registration

getBeanRegistrationsForField

@Internal
protected final Object getBeanRegistrationsForField(BeanResolutionContext resolutionContext,
                                                              BeanContext context,
                                                              int fieldIndex)

Obtains all bean definitions for a field injection point.

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; fieldIndex - The field index
Returns:: The resolved bean

getBeanRegistrationForField

@Internal
protected final BeanRegistration<?> getBeanRegistrationForField(BeanResolutionContext resolutionContext,
                                                                          BeanContext context,
                                                                          int fieldIndex)

Obtains a bean registration for a field injection point.

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; fieldIndex - The field index
Returns:: The resolved bean registration

getBeanRegistrationsForMethodArgument

@Internal
protected final Object getBeanRegistrationsForMethodArgument(BeanResolutionContext resolutionContext,
                                                                       BeanContext context,
                                                                       int methodIndex,
                                                                       int argIndex)

Obtains all bean definitions for a method injection point.

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; methodIndex - The method index; argIndex - The arg index
Returns:: The resolved bean

getBeanRegistrationForMethodArgument

@Internal
protected final BeanRegistration<?> getBeanRegistrationForMethodArgument(BeanResolutionContext resolutionContext,
                                                                                   BeanContext context,
                                                                                   int methodIndex,
                                                                                   int argIndex)

Obtains a bean registration for a method injection point.

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; methodIndex - The method index; argIndex - The arg index
Returns:: The resolved bean registration

streamOfTypeForConstructorArgument

@Internal
protected final Stream streamOfTypeForConstructorArgument(BeanResolutionContext resolutionContext,
                                                                    BeanContext context,
                                                                    ConstructorInjectionPoint<T> constructorInjectionPoint,
                                                                    Argument argument)

Obtains all bean definitions for a constructor argument at the given index

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; constructorInjectionPoint - The constructor injection point; argument - The argument
Returns:: The resolved bean

findBeanForConstructorArgument

@Internal
protected final Optional findBeanForConstructorArgument(BeanResolutionContext resolutionContext,
                                                                  BeanContext context,
                                                                  ConstructorInjectionPoint<T> constructorInjectionPoint,
                                                                  Argument argument)

Obtains all bean definitions for a constructor argument at the given index

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; constructorInjectionPoint - The constructor injection point; argument - The argument
Returns:: The resolved bean

getBeanForField
```
@Internal
protected final Object getBeanForField(BeanResolutionContext resolutionContext,
                                                 BeanContext context,
                                                 int fieldIndex)
```
Obtains a bean definition for the field at the given index and the argument at the given index
Warning: this method is used by internal generated code and should not be called by user code.

Parameters:

resolutionContext - The resolution context

context - The context

fieldIndex - The field index

Returns:

The resolved bean

getValueForField
```
@Internal
protected final Object getValueForField(BeanResolutionContext resolutionContext,
                                                  BeanContext context,
                                                  int fieldIndex)
```
Obtains a value for the given field from the bean context
Warning: this method is used by internal generated code and should not be called by user code.

Parameters:

resolutionContext - The resolution context

context - The context

fieldIndex - The index of the field

Returns:

The resolved bean

getValueForPath

@Internal
protected final <T1> Optional<T1> getValueForPath(BeanResolutionContext resolutionContext,
                                                            BeanContext context,
                                                            Argument<T1> propertyType,
                                                            String... propertyPath)

Resolve a value for the given field of the given type and path. Only used by applications compiled with versions of Micronaut prior to 1.2.0.

Type Parameters:: T1 - The generic type
Parameters:: resolutionContext - The resolution context; context - The bean context; propertyType - The required property type; propertyPath - The property path
Returns:: An optional value

getValueForPath

@Internal
protected final <T1> Optional<T1> getValueForPath(BeanResolutionContext resolutionContext,
                                                            BeanContext context,
                                                            Argument<T1> propertyType,
                                                            String propertyPath)

Resolve a value for the given field of the given type and path.

Type Parameters:: T1 - The generic type
Parameters:: resolutionContext - The resolution context; context - The bean context; propertyType - The required property type; propertyPath - The property path
Returns:: An optional value

containsValueForField

@Internal
protected final boolean containsValueForField(BeanResolutionContext resolutionContext,
                                                        BeanContext context,
                                                        int fieldIndex)

Obtains a value for the given field argument.

Parameters:: resolutionContext - The resolution context; context - The bean context; fieldIndex - The field index
Returns:: True if it does

containsProperties

@Internal
protected final boolean containsProperties(BeanResolutionContext resolutionContext,
                                                     BeanContext context)

If this bean is a ConfigurationProperties bean return whether any properties for it are configured within the context.

Parameters:: resolutionContext - the resolution context; context - The context
Returns:: True if it does

containsProperties

@Internal
protected final boolean containsProperties(BeanResolutionContext resolutionContext,
                                                     BeanContext context,
                                                     String subProperty)

If this bean is a ConfigurationProperties bean return whether any properties for it are configured within the context.

Parameters:: resolutionContext - the resolution context; context - The context; subProperty - The subproperty to check
Returns:: True if it does

getBeanForField

@Internal
protected final Object getBeanForField(BeanResolutionContext resolutionContext,
                                                 BeanContext context,
                                                 FieldInjectionPoint injectionPoint)

Resolves a bean for the given FieldInjectionPoint.

Parameters:: resolutionContext - The BeanResolutionContext; context - The BeanContext; injectionPoint - The FieldInjectionPoint
Returns:: The resolved bean
Throws:: DependencyInjectionException - If the bean cannot be resolved

findBeanForField

@Internal
protected final Optional findBeanForField(BeanResolutionContext resolutionContext,
                                                    BeanContext context,
                                                    FieldInjectionPoint injectionPoint)

Obtains a an optional for the field at the given index and the argument at the given index

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; injectionPoint - The field injection point
Returns:: The resolved bean

getBeansOfTypeForField

@Internal
protected final Collection getBeansOfTypeForField(BeanResolutionContext resolutionContext,
                                                            BeanContext context,
                                                            FieldInjectionPoint injectionPoint)

Obtains a bean definition for the field at the given index and the argument at the given index

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; injectionPoint - The field injection point
Returns:: The resolved bean

getStreamOfTypeForField

@Internal
protected final Stream getStreamOfTypeForField(BeanResolutionContext resolutionContext,
                                                         BeanContext context,
                                                         FieldInjectionPoint injectionPoint)

Obtains a bean definition for the field at the given index and the argument at the given index

Warning: this method is used by internal generated code and should not be called by user code.

Parameters:: resolutionContext - The resolution context; context - The context; injectionPoint - The field injection point
Returns:: The resolved bean

getTypeArgumentsMap
```
@Internal
protected Map<String,Argument<?>[]> getTypeArgumentsMap()
```
A method that subclasses can override to provide information on type arguments.

Returns:

The type arguments

resolveAnnotationMetadata
```
protected AnnotationMetadata resolveAnnotationMetadata()
```
Resolves the annotation metadata for this bean. Subclasses

Returns:

The AnnotationMetadata

isEnabled
```
public boolean isEnabled(@NonNull
                         BeanContext context,
                         @Nullable
                         BeanResolutionContext resolutionContext)
```
Description copied from interface: BeanContextConditional

Return whether this component is enabled for the given context.

Specified by:

isEnabled in interface BeanContextConditional

Parameters:

context - The context

resolutionContext - The bean resolution context

Returns:

True if it is

Class AbstractBeanDefinition<T>

Field Summary

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

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

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface io.micronaut.inject.BeanDefinition

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

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

Methods inherited from interface io.micronaut.inject.BeanType

Methods inherited from interface io.micronaut.inject.BeanContextConditional

Field Detail

methodInjectionPoints

fieldInjectionPoints

postConstructMethods

preDestroyMethods

executableMethodMap

Constructor Detail

AbstractBeanDefinition

AbstractBeanDefinition

AbstractBeanDefinition

Method Detail

getContainerElement

hasPropertyExpressions

getTypeArguments

getAnnotationMetadata

isAbstract

isIterable

isPrimary

findMethod

findPossibleMethods

equals

hashCode

toString

isProvided

getScope

getScopeName

getBeanType

getExposedTypes

getDeclaringType

getConstructor

getRequiredComponents

getInjectedMethods

getInjectedFields

getPostConstructMethods

getPreDestroyMethods

getName

inject

inject

getExecutableMethods

configure

warn

warnMissingProperty

getProxiedBean

addExecutableMethod

addInjectionPoint

addInjectionPoint

addPostConstruct

addPreDestroy

injectBean

injectAnother

postConstruct

preDestroy

injectBeanMethod

injectBeanField

getValueForMethodArgument

containsValueForMethodArgument

getBeanForMethodArgument

getBeansOfTypeForMethodArgument

findBeanForMethodArgument

streamOfTypeForMethodArgument

getBeanForConstructorArgument

getValueForConstructorArgument

getBeansOfTypeForConstructorArgument

getBeansOfTypeForConstructorArgument

getBeansOfTypeForMethodArgument

getBeansOfTypeForField

getBeanRegistrationsForConstructorArgument

getBeanRegistrationForConstructorArgument