Package io.micronaut.inject.beans

Class AbstractInitializableBeanIntrospection<B>

java.lang.Object

io.micronaut.inject.beans.AbstractInitializableBeanIntrospection<B>

Type Parameters:

B - The bean type

All Implemented Interfaces:

AnnotationMetadata, AnnotationMetadataDelegate, AnnotationMetadataProvider, AnnotationSource, BeanInfo<B>, BeanIntrospection<B>, UnsafeBeanInstantiationIntrospection<B>, Ordered, ArgumentCoercible<B>

Direct Known Subclasses:

AbstractInitializableBeanIntrospectionAndReference

public abstract class AbstractInitializableBeanIntrospection<B>
extends Object
implements UnsafeBeanInstantiationIntrospection<B>

Abstract implementation of the BeanIntrospection interface. This class is subclasses at compilation time by generated byte code and should not be used directly.

Implementation is using method dispatch to access the bean instance.

Since:

3.1

Author:

Denis Stepanov

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	AbstractInitializableBeanIntrospection.BeanMethodRef<P>	Bean method compile-time data container.
static final class	AbstractInitializableBeanIntrospection.BeanPropertyRef<P>	Bean property compile-time data container.

Nested classes/interfaces inherited from interface io.micronaut.core.beans.BeanIntrospection

BeanIntrospection.Builder<T>

Field Summary

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

Fields inherited from interface io.micronaut.core.order.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractInitializableBeanIntrospection(Class<B> beanType, AnnotationMetadata annotationMetadata, AnnotationMetadata constructorAnnotationMetadata, Argument<?>[] constructorArguments, AbstractInitializableBeanIntrospection.BeanPropertyRef<Object>[] propertiesRefs, AbstractInitializableBeanIntrospection.BeanMethodRef<Object>[] methodsRefs)

Method Summary

Modifier and Type	Method	Description
BeanIntrospection.Builder<B>	builder()
protected <V> V	dispatch(int index, B target, @Nullable Object[] args)	Triggers the invocation of the method at index.
protected <V> V	dispatchOne(int index, @NonNull Object target, @Nullable Object arg)	Triggers the invocation of the method at index for a single argument call.
boolean	equals(Object o)
@Nullable BeanProperty<B,Object>	findIndexedProperty(@NonNull Class<? extends Annotation> annotationType, @NonNull String annotationValue)	Get all the bean properties annotated for the given type.
protected final Method	getAccessibleTargetMethodByIndex(int index)	Find Method representation at the method by index.
AnnotationMetadata	getAnnotationMetadata()	Supplies the metadata.
@NonNull Collection<BeanMethod<B,Object>>	getBeanMethods()	Returns the BeanMethod instances for this introspection.
@NonNull Collection<BeanProperty<B,Object>>	getBeanProperties()
protected Collection<BeanProperty<B,Object>>	getBeanPropertiesIndexedSubset(int[] indexes)	Returns subset of bean properties defined by an array of indexes.
List<BeanReadProperty<B,Object>>	getBeanReadProperties()
@NonNull Class<B>	getBeanType()	The bean type.
List<BeanWriteProperty<B,Object>>	getBeanWriteProperties()
BeanConstructor<B>	getConstructor()
Argument<?>[]	getConstructorArguments()	The constructor arguments needed to instantiate the bean.
@NonNull Collection<BeanProperty<B,Object>>	getIndexedProperties(@NonNull Class<? extends Annotation> annotationType)	Get all the bean properties annotated for the given annotation type.
@NonNull Optional<BeanProperty<B,Object>>	getIndexedProperty(@NonNull Class<? extends Annotation> annotationType, @NonNull String annotationValue)	Get all the bean properties annotated for the given type.
@NonNull Optional<BeanProperty<B,Object>>	getProperty(@NonNull String name)	Obtain a property by name.
protected BeanProperty<B,Object>	getPropertyByIndex(int index)	Obtain a property by its index.
protected abstract Method	getTargetMethodByIndex(int index)	Find Method representation at the method by index.
protected boolean	hasConstructor()	Whether an accessible constructor exists.
int	hashCode()
B	instantiate()	Instantiates an instance of the bean, throwing an exception is instantiation is not possible.
B	instantiate(boolean strictNullable, Object... arguments)	Instantiates an instance of the bean, throwing an exception is instantiation is not possible.
protected B	instantiateInternal(@Nullable Object[] arguments)	Reflection free bean instantiation implementation for the given arguments.
B	instantiateUnsafe(@NonNull Object... arguments)	Instantiates an instance of the bean.
int	propertyIndexOf(String name)	Obtain the property index position.
String	toString()
protected final RuntimeException	unknownDispatchAtIndexException(int index)	Creates a new exception when the dispatch at index is not found.

Methods inherited from class java.lang.Object

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

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

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

Methods inherited from interface io.micronaut.core.annotation.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, 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 io.micronaut.core.beans.BeanInfo

asArgument, getGenericBeanType, getOrder

Methods inherited from interface io.micronaut.core.beans.BeanIntrospection

getIndexedProperty, getProperty, getPropertyNames, getReadProperty, getReadProperty, getReadPropertyNames, getRequiredProperty, getRequiredReadProperty, getRequiredWriteProperty, getWriteProperty, getWriteProperty, hasBuilder, instantiate, isBuildable

Constructor Details

AbstractInitializableBeanIntrospection

protected AbstractInitializableBeanIntrospection(Class<B> beanType,
 AnnotationMetadata annotationMetadata,
 AnnotationMetadata constructorAnnotationMetadata,
 Argument<?>[] constructorArguments,
 AbstractInitializableBeanIntrospection.BeanPropertyRef<Object>[] propertiesRefs,
 AbstractInitializableBeanIntrospection.BeanMethodRef<Object>[] methodsRefs)

Method Details

builder

public BeanIntrospection.Builder<B> builder()

Specified by:

builder in interface BeanIntrospection<B>

Returns:

Obtain a builder for this introspection.

hasConstructor

protected boolean hasConstructor()

Whether an accessible constructor exists.

Returns:

True if a default constructor exists

Since:

4.7.11

instantiateInternal

@NonNull
@Internal
protected B instantiateInternal(@Nullable
 @Nullable Object[] arguments)

Reflection free bean instantiation implementation for the given arguments.

Parameters:

arguments - The arguments

Returns:

The bean

getPropertyByIndex

@Internal
protected BeanProperty<B,Object> getPropertyByIndex(int index)

Obtain a property by its index.

Parameters:

index - The index of the property

Returns:

A bean property

propertyIndexOf

public int propertyIndexOf(String name)

Description copied from interface: BeanIntrospection

Obtain the property index position.

Specified by:

propertyIndexOf in interface BeanIntrospection<B>

Parameters:

name - The name of the property

Returns:

A property index or -1 of not found.

getTargetMethodByIndex

@Internal
protected abstract Method getTargetMethodByIndex(int index)

Find Method representation at the method by index. Used by MethodReference.getTargetMethod().

Parameters:

index - The index

Returns:

The method

getAccessibleTargetMethodByIndex

protected final Method getAccessibleTargetMethodByIndex(int index)

Find Method representation at the method by index. Used by MethodReference.getTargetMethod().

Parameters:

index - The index

Returns:

The method

Since:

3.8.5

dispatch

@Nullable
protected <V> V dispatch(int index,
 @NonNull
 B target,
 @Nullable
 @Nullable Object[] args)

Triggers the invocation of the method at index.

Type Parameters:

V - The result type

Parameters:

index - The method index

target - The target

args - The arguments

Returns:

The result

dispatchOne

@Nullable
protected <V> V dispatchOne(int index,
 @NonNull
 @NonNull Object target,
 @Nullable
 @Nullable Object arg)

Triggers the invocation of the method at index for a single argument call. Allowing to not wrap a single argument in an object array.

Type Parameters:

V - The result type

Parameters:

index - The method index

target - The target

arg - The argument

Returns:

The result

unknownDispatchAtIndexException

protected final RuntimeException unknownDispatchAtIndexException(int index)

Creates a new exception when the dispatch at index is not found.

Parameters:

index - The method index

Returns:

The exception

findIndexedProperty

@Nullable
public @Nullable BeanProperty<B,Object> findIndexedProperty(@NonNull
 @NonNull Class<? extends Annotation> annotationType,
 @NonNull
 @NonNull String annotationValue)

Get all the bean properties annotated for the given type. Nullable result method version of getIndexedProperty(Class, String).

Parameters:

annotationType - The annotation type

annotationValue - The annotation value

Returns:

An immutable collection of properties.

See Also:

• Introspected.indexed()

getIndexedProperties

@NonNull
public @NonNull Collection<BeanProperty<B,Object>> getIndexedProperties(@NonNull
 @NonNull Class<? extends Annotation> annotationType)

Description copied from interface: BeanIntrospection

Get all the bean properties annotated for the given annotation type. If the annotation is Introspected.indexed() by the given annotation, then it will be included in the resulting list.

Specified by:

getIndexedProperties in interface BeanIntrospection<B>

Parameters:

annotationType - The annotation type

Returns:

An immutable collection of properties.

See Also:

• Introspected.indexed()

getBeanPropertiesIndexedSubset

protected Collection<BeanProperty<B,Object>> getBeanPropertiesIndexedSubset(int[] indexes)

Returns subset of bean properties defined by an array of indexes.

Parameters:

indexes - The indexes

Returns:

a collection of bean properties

instantiate

public B instantiate()
              throws InstantiationException

Description copied from interface: BeanIntrospection

Instantiates an instance of the bean, throwing an exception is instantiation is not possible.

Specified by:

instantiate in interface BeanIntrospection<B>

Returns:

An instance

Throws:

InstantiationException - If the bean cannot be instantiated or the arguments are not satisfied.

instantiate

@NonNull
public B instantiate(boolean strictNullable,
 Object... arguments)
              throws InstantiationException

Description copied from interface: BeanIntrospection

Instantiates an instance of the bean, throwing an exception is instantiation is not possible.

Specified by:

instantiate in interface BeanIntrospection<B>

Parameters:

strictNullable - If true, require null parameters to be annotated with a nullable annotation

arguments - The arguments required to instantiate bean. Should match the types returned by BeanIntrospection.getConstructorArguments()

Returns:

An instance

Throws:

InstantiationException - If the bean cannot be instantiated.

instantiateUnsafe

public B instantiateUnsafe(@NonNull
 @NonNull Object... arguments)

Description copied from interface: UnsafeBeanInstantiationIntrospection

Instantiates an instance of the bean.

Specified by:

instantiateUnsafe in interface UnsafeBeanInstantiationIntrospection<B>

Parameters:

arguments - The arguments required to instantiate bean.

Returns:

An instance

getConstructor

public BeanConstructor<B> getConstructor()

Specified by:

getConstructor in interface BeanIntrospection<B>

Returns:

The bean constructor.

getConstructorArguments

public Argument<?>[] getConstructorArguments()

Description copied from interface: BeanIntrospection

The constructor arguments needed to instantiate the bean.

Specified by:

getConstructorArguments in interface BeanIntrospection<B>

Returns:

An argument array

getIndexedProperty

@NonNull
public @NonNull Optional<BeanProperty<B,Object>> getIndexedProperty(@NonNull
 @NonNull Class<? extends Annotation> annotationType,
 @NonNull
 @NonNull String annotationValue)

Description copied from interface: BeanIntrospection

Get all the bean properties annotated for the given type.

Specified by:

getIndexedProperty in interface BeanIntrospection<B>

Parameters:

annotationType - The annotation type

annotationValue - The annotation value

Returns:

An immutable collection of properties.

See Also:

• Introspected.indexed()

getProperty

@NonNull
public @NonNull Optional<BeanProperty<B,Object>> getProperty(@NonNull
 @NonNull String name)

Description copied from interface: BeanIntrospection

Obtain a property by name.

Specified by:

getProperty in interface BeanIntrospection<B>

Parameters:

name - The name of the property

Returns:

A bean property if found

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

getBeanProperties

@NonNull
public @NonNull Collection<BeanProperty<B,Object>> getBeanProperties()

Specified by:

getBeanProperties in interface BeanIntrospection<B>

Returns:

An immutable collection of properties.

getBeanReadProperties

public List<BeanReadProperty<B,Object>> getBeanReadProperties()

Specified by:

getBeanReadProperties in interface BeanIntrospection<B>

Returns:

An immutable collection of read properties.

getBeanWriteProperties

public List<BeanWriteProperty<B,Object>> getBeanWriteProperties()

Specified by:

getBeanWriteProperties in interface BeanIntrospection<B>

Returns:

An immutable collection of write properties.

getBeanType

@NonNull
public @NonNull Class<B> getBeanType()

Description copied from interface: BeanIntrospection

The bean type.

Specified by:

getBeanType in interface BeanInfo<B>

Specified by:

getBeanType in interface BeanIntrospection<B>

Returns:

The bean type

getBeanMethods

@NonNull
public @NonNull Collection<BeanMethod<B,Object>> getBeanMethods()

Description copied from interface: BeanIntrospection

Returns the BeanMethod instances for this introspection.

The BeanMethod instances are only those methods annotated with io.micronaut.context.annotation.Executable and hence represent a subset of the actual methods of the class and do not include any methods that are exposed as BeanProperty instances.

Specified by:

getBeanMethods in interface BeanIntrospection<B>

Returns:

An immutable collection of 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