io.micronaut.core.beans

Class AbstractBeanIntrospection<T>

java.lang.Object

io.micronaut.core.beans.AbstractBeanIntrospection<T>

Type Parameters:

T - The generic type

All Implemented Interfaces:

AnnotationMetadata, AnnotationMetadataDelegate, AnnotationMetadataProvider, AnnotationSource, BeanIntrospection<T>

@Internal
public abstract class AbstractBeanIntrospection<T>
extends Object
implements BeanIntrospection<T>

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

Since:

1.1

Author:

graemerocher

Field Summary

Fields

Modifier and Type	Field and Description
protected AnnotationMetadata	annotationMetadata
protected List<BeanMethod<T,Object>>	beanMethods
protected Map<String,BeanProperty<T,Object>>	beanProperties
protected Class<T>	beanType

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	AbstractBeanIntrospection(Class<T> beanType, AnnotationMetadata annotationMetadata, int propertyCount) Base class for bean instrospections.
protected	AbstractBeanIntrospection(Class<T> beanType, AnnotationMetadata annotationMetadata, int propertyCount, int methodCount) Base class for bean instrospections.

Method Summary

Modifier and Type	Method and Description
protected void	addMethod(BeanMethod<T,Object> method) Adds a method to the introspection.
protected void	addProperty(BeanProperty<T,Object> property) Adds a property at a particular index of the internal array passed to the constructor.
boolean	equals(Object o)
AnnotationMetadata	getAnnotationMetadata() Supplies the metadata.
Collection<BeanMethod<T,Object>>	getBeanMethods() Returns the BeanMethod instances for this introspection.
Collection<BeanProperty<T,Object>>	getBeanProperties()
Class<T>	getBeanType() The bean type.
BeanConstructor<T>	getConstructor()
protected AnnotationMetadata	getConstructorAnnotationMetadata()
Collection<BeanProperty<T,Object>>	getIndexedProperties(Class<? extends Annotation> annotationType) Get all the bean properties annotated for the given annotation type.
Optional<BeanProperty<T,Object>>	getIndexedProperty(Class<? extends Annotation> annotationType, String annotationValue) Get all the bean properties annotated for the given type.
Optional<BeanProperty<T,Object>>	getProperty(String name) Obtain a property by name.
int	hashCode()
protected void	indexProperty(Class<? extends Annotation> annotationType, String propertyName) Used to produce an index for particular annotation type.
protected void	indexProperty(Class<? extends Annotation> annotationType, String propertyName, String annotationValue) Used to produce an index for particular annotation type.
T	instantiate(boolean strictNullable, Object... arguments) Instantiates an instance of the bean, throwing an exception is instantiation is not possible.
protected abstract T	instantiateInternal(Object[] arguments) Reflection free bean instantiation implementation for the given arguments.
int	propertyIndexOf(String name) Obtain the property index position.
String	toString()

Methods inherited from class java.lang.Object

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

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

getConstructorArguments, getIndexedProperty, getIntrospection, getProperty, getPropertyNames, getRequiredProperty, instantiate, instantiate

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, getDeclaredAnnotationValuesByName, getValues, hasDeclaredStereotype, isAnnotationPresent, isDeclaredAnnotationPresent

Field Detail

annotationMetadata

protected final AnnotationMetadata annotationMetadata

beanType

protected final Class<T> beanType

beanProperties

protected final Map<String,BeanProperty<T,Object>> beanProperties

beanMethods

protected final List<BeanMethod<T,Object>> beanMethods

Constructor Detail

AbstractBeanIntrospection

protected AbstractBeanIntrospection(@NonNull
                                    Class<T> beanType,
                                    @Nullable
                                    AnnotationMetadata annotationMetadata,
                                    int propertyCount)

Base class for bean instrospections.

Parameters:

beanType - The bean type

annotationMetadata - The annotation metadata

propertyCount - The property count

AbstractBeanIntrospection

protected AbstractBeanIntrospection(@NonNull
                                    Class<T> beanType,
                                    @Nullable
                                    AnnotationMetadata annotationMetadata,
                                    int propertyCount,
                                    int methodCount)

Base class for bean instrospections.

Parameters:

beanType - The bean type

annotationMetadata - The annotation metadata

propertyCount - The property count

methodCount - The method count

Method Detail

getConstructor

public BeanConstructor<T> getConstructor()

Specified by:

getConstructor in interface BeanIntrospection<T>

Returns:

The bean constructor.

getConstructorAnnotationMetadata

protected AnnotationMetadata getConstructorAnnotationMetadata()

Returns:

Annotation metadata for the constructor.

Since:

3.0.0

getIndexedProperty

@NonNull
public Optional<BeanProperty<T,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<T>

Parameters:

annotationType - The annotation type

annotationValue - The annotation value

Returns:

A immutable collection of properties.

See Also:

Introspected.indexed()

instantiate

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

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.

getProperty

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

Description copied from interface: BeanIntrospection

Obtain a property by name.

Specified by:

getProperty in interface BeanIntrospection<T>

Parameters:

name - The name of the property

Returns:

A bean property if found

propertyIndexOf

public int propertyIndexOf(String name)

Description copied from interface: BeanIntrospection

Obtain the property index position.

Specified by:

propertyIndexOf in interface BeanIntrospection<T>

Parameters:

name - The name of the property

Returns:

A property index or -1 of not found.

getIndexedProperties

@NonNull
public Collection<BeanProperty<T,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<T>

Parameters:

annotationType - The annotation type

Returns:

A immutable collection of properties.

See Also:

Introspected.indexed()

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<T,Object>> getBeanProperties()

Specified by:

getBeanProperties in interface BeanIntrospection<T>

Returns:

A immutable collection of properties.

getBeanType

@NonNull
public Class<T> getBeanType()

Description copied from interface: BeanIntrospection

The bean type.

Specified by:

getBeanType in interface BeanIntrospection<T>

Returns:

The bean type

instantiateInternal

@Internal
protected abstract T instantiateInternal(Object[] arguments)

Reflection free bean instantiation implementation for the given arguments.

Parameters:

arguments - The arguments

Returns:

The bean

addProperty

@Internal
protected final void addProperty(@NonNull
                                           BeanProperty<T,Object> property)

Adds a property at a particular index of the internal array passed to the constructor. Used by generated byte code for subclasses and not for public consumption.

Parameters:

property - The property.

addMethod

@Internal
protected final void addMethod(@NonNull
                                         BeanMethod<T,Object> method)

Adds a method to the introspection. Used by generated byte code for subclasses and not for public consumption.

Parameters:

method - The property.

getBeanMethods

@NonNull
public Collection<BeanMethod<T,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<T>

Returns:

A immutable collection of methods.

indexProperty

@Internal
protected final void indexProperty(@NonNull
                                             Class<? extends Annotation> annotationType,
                                             @NonNull
                                             String propertyName)

Used to produce an index for particular annotation type. Method referenced by generated byte code and not for public consumption. Should be called after addProperty(BeanProperty) if required.

Parameters:

annotationType - The annotation type

propertyName - The property name

indexProperty

@Internal
protected final void indexProperty(@NonNull
                                             Class<? extends Annotation> annotationType,
                                             @NonNull
                                             String propertyName,
                                             @Nullable
                                             String annotationValue)

Used to produce an index for particular annotation type. Method referenced by generated byte code and not for public consumption. Should be called after addProperty(BeanProperty) if required.

Parameters:

annotationType - The annotation type

propertyName - The property name

annotationValue - The annotation value

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