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, BeanIntrospection<B>

public abstract class AbstractInitializableBeanIntrospection<B>
extends Object
implements BeanIntrospection<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 and Description
static class	AbstractInitializableBeanIntrospection.BeanMethodRef<P> Bean method compile-time data container.
static class	AbstractInitializableBeanIntrospection.BeanPropertyRef<P> Bean property compile-time data container.

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

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
protected <V> V	dispatch(int index, B target, Object[] args) Triggers the invocation of the method at index.
protected <V> V	dispatchOne(int index, Object target, Object arg) Triggers the invocation of the method at index for a single argument call.
boolean	equals(Object o)
BeanProperty<B,Object>	findIndexedProperty(Class<? extends Annotation> annotationType, String annotationValue) Get all the bean properties annotated for the given type.
protected Method	getAccessibleTargetMethodByIndex(int index) Find Method representation at the method by index.
AnnotationMetadata	getAnnotationMetadata() Supplies the metadata.
Collection<BeanMethod<B,Object>>	getBeanMethods() Returns the BeanMethod instances for this introspection.
Collection<BeanProperty<B,Object>>	getBeanProperties()
protected Collection<BeanProperty<B,Object>>	getBeanPropertiesIndexedSubset(int[] indexes) Returns subset of bean properties defined by an array of indexes.
Class<B>	getBeanType() The bean type.
BeanConstructor<B>	getConstructor()
Argument<?>[]	getConstructorArguments() The constructor arguments needed to instantiate the bean.
Collection<BeanProperty<B,Object>>	getIndexedProperties(Class<? extends Annotation> annotationType) Get all the bean properties annotated for the given annotation type.
Optional<BeanProperty<B,Object>>	getIndexedProperty(Class<? extends Annotation> annotationType, String annotationValue) Get all the bean properties annotated for the given type.
Optional<BeanProperty<B,Object>>	getProperty(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.
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 abstract B	instantiateInternal(Object[] arguments) Reflection free bean instantiation implementation for the given arguments.
String	toString()
protected 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.beans.BeanIntrospection

getIndexedProperty, getIntrospection, getProperty, getPropertyNames, getRequiredProperty, instantiate, propertyIndexOf

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, 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.annotation.AnnotationMetadata

getAnnotationValuesByName, getAnnotationValuesByStereotype, getDeclaredAnnotationValuesByName, getValues, hasDeclaredStereotype, isAnnotationPresent, isDeclaredAnnotationPresent

Constructor Detail

AbstractInitializableBeanIntrospection

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

Method Detail

instantiateInternal

@NonNull
 @Internal
protected abstract B instantiateInternal(@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

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
                                   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
                                      Object target,
                                      @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 BeanProperty<B,Object> findIndexedProperty(@NonNull
                                                            Class<? extends Annotation> annotationType,
                                                            @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:

A immutable collection of properties.

See Also:

Introspected.indexed()

getIndexedProperties

@NonNull
public Collection<BeanProperty<B,Object>> getIndexedProperties(@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:

A 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.

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 Optional<BeanProperty<B,Object>> getIndexedProperty(@NonNull
                                                                    Class<? extends Annotation> annotationType,
                                                                    @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:

A immutable collection of properties.

See Also:

Introspected.indexed()

getProperty

@NonNull
public Optional<BeanProperty<B,Object>> getProperty(@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 Collection<BeanProperty<B,Object>> getBeanProperties()

Specified by:

getBeanProperties in interface BeanIntrospection<B>

Returns:

A immutable collection of properties.

getBeanType

@NonNull
public Class<B> getBeanType()

Description copied from interface: BeanIntrospection

The bean type.

Specified by:

getBeanType in interface BeanIntrospection<B>

Returns:

The bean type

getBeanMethods

@NonNull
public 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:

A 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