Class SupplementedBeanIntrospection<T>

java.lang.Object

io.micronaut.reflection.SupplementedBeanIntrospection<T>

Type Parameters:

T - The bean type

All Implemented Interfaces:

AnnotationMetadata, AnnotationMetadataDelegate, AnnotationMetadataProvider, AnnotationSource, BeanInfo<T>, BeanIntrospection<T>, Ordered, ArgumentCoercible<T>, ReflectiveIntrospection<T>

public final class SupplementedBeanIntrospection<T>
extends Object
implements ReflectiveIntrospection<T>

A generated BeanIntrospection completed by a reflective one: the properties, the constructor and the methods the processor generated are served as generated, and the executables it left out — the methods that are not @Executable, the other constructors — come from reflection.

A processor generates what the application needs; a specification describing the type needs all of it. This keeps one introspection per type, generated where it exists.

Since:

5.2.0

Author:

Denis Stepanov

Nested Class Summary

Nested classes/interfaces inherited from interface BeanIntrospection

BeanIntrospection.Builder<T>

Nested classes/interfaces inherited from interface ReflectiveIntrospection

ReflectiveIntrospection.ReflectivePropertyMember<B>

Field Summary

Fields inherited from interface AnnotationMetadata

CLASS_NAME_SUFFIX, EMPTY_METADATA, VALUE_MEMBER

Fields inherited from interface AnnotationSource

EMPTY

Fields inherited from interface Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor	Description
SupplementedBeanIntrospection(BeanIntrospection<T> generated, ReflectionBeanIntrospection<T> reflected)	Creates an introspection completing a generated one with a reflective one.

Method Summary

Modifier and Type	Method	Description
BeanIntrospection.Builder<T>	builder()
Optional<BeanMethod<T,Object>>	findDeclaredMethod(String name, Class<?>... parameterTypes)	Finds the method the introspected type itself declares, with the annotations of that declaration only: the generated metadata of a method merges the annotations of the methods it overrides.
AnnotationMetadata	getAnnotationMetadata()	Supplies the metadata.
Collection<BeanMethod<T,Object>>	getBeanMethods()	Returns the BeanMethod instances for this introspection.
Collection<BeanProperty<T,Object>>	getBeanProperties()	The generated properties, each with the type arguments the reflection reads from every member: the getter of an interface can declare Map<String, @NotBlank String> where the field is a plain Map<String, String>.
List<BeanReadProperty<T,Object>>	getBeanReadProperties()	The read properties the generated introspection reports, each as it reports it, completed by the ones of a property it does not describe at all.
Class<T>	getBeanType()	The bean type.
List<BeanWriteProperty<T,Object>>	getBeanWriteProperties()	The write properties the generated introspection reports, each as it reports it, completed by the ones of a property it does not describe at all, the way getBeanReadProperties() completes the read ones.
BeanConstructor<T>	getConstructor()	The generated constructor, with the metadata the reflection reads from the constructor when the generated one carries none: a generated introspection instantiates, it does not describe.
Argument<?>[]	getConstructorArguments()	The constructor arguments needed to instantiate the bean.
List<BeanConstructor<T>>	getConstructors()	Returns the constructors this introspection describes.
BeanIntrospection<T>	getGenerated()	The generated introspection this one completes.
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.
boolean	hasBuilder()	Does the introspection have a backing builder.
T	instantiate()	Instantiates an instance of the bean, throwing an exception is instantiation is not possible.
T	instantiate(boolean strictNullable, @Nullable Object... arguments)	Instantiates an instance of the bean, throwing an exception is instantiation is not possible.
boolean	isBuildable()	Can the introspection be constructed with BeanIntrospection.builder().
String	toString()

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface AnnotationMetadata

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

Methods inherited from interface AnnotationMetadataDelegate

booleanValue, booleanValue, booleanValue, booleanValue, classValue, classValue, classValue, classValue, classValues, classValues, classValues, classValues, copyAnnotationMetadata, doubleValue, doubleValue, doubleValue, enumValue, enumValue, enumValue, enumValue, enumValues, enumValues, enumValues, enumValues, findAnnotation, findAnnotation, findDeclaredAnnotation, findDeclaredAnnotation, findRepeatableAnnotation, findRepeatableAnnotation, getAnnotation, getAnnotation, getAnnotationNameByStereotype, getAnnotationNameByStereotype, getAnnotationNames, getAnnotationNamesByStereotype, getAnnotationNamesByStereotype, getAnnotationType, getAnnotationType, getAnnotationTypeByStereotype, getAnnotationTypeByStereotype, getAnnotationTypesByStereotype, getAnnotationTypesByStereotype, getAnnotationTypesByStereotype, getAnnotationValuesByName, getAnnotationValuesByStereotype, getAnnotationValuesByType, getDeclaredAnnotation, getDeclaredAnnotation, getDeclaredAnnotationNameByStereotype, getDeclaredAnnotationNames, getDeclaredAnnotationNamesByStereotype, getDeclaredAnnotationTypeByStereotype, getDeclaredAnnotationTypeByStereotype, getDeclaredAnnotationValuesByName, getDeclaredAnnotationValuesByType, getDeclaredMetadata, getDeclaredStereotypeAnnotationNames, getDefaultValue, getDefaultValue, getDefaultValue, getDefaultValue, getDefaultValues, getStereotypeAnnotationNames, getTargetAnnotationMetadata, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValues, getValues, hasAnnotation, hasAnnotation, hasDeclaredAnnotation, hasDeclaredAnnotation, hasDeclaredStereotype, hasDeclaredStereotype, hasDeclaredStereotype, hasEvaluatedExpressions, 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 BeanInfo

asArgument, getGenericBeanType, getOrder

Methods inherited from interface BeanIntrospection

getIndexedProperty, getProperty, getPropertyNames, getReadProperty, getReadProperty, getReadPropertyNames, getRequiredProperty, getRequiredReadProperty, getRequiredWriteProperty, getTypeArguments, getTypeArguments, getTypeArguments, getWriteProperty, getWriteProperty, instantiate, propertyIndexOf

Methods inherited from interface ReflectiveIntrospection

separatesDeclarations

Constructor Details

SupplementedBeanIntrospection

public SupplementedBeanIntrospection(BeanIntrospection<T> generated,
 ReflectionBeanIntrospection<T> reflected)

Creates an introspection completing a generated one with a reflective one.

Parameters:

generated - The generated introspection

reflected - The reflective introspection of the same type

Method Details

getGenerated

public BeanIntrospection<T> getGenerated()

The generated introspection this one completes.

Returns:

The generated introspection

getBeanType

public Class<T> getBeanType()

Description copied from interface: BeanIntrospection

The bean type.

Specified by:

getBeanType in interface BeanInfo<T>

Specified by:

getBeanType in interface BeanIntrospection<T>

Returns:

The bean type

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

getIndexedProperties

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

An immutable collection of properties.

See Also:

• Introspected.indexed()

getIndexedProperty

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

An immutable collection of properties.

See Also:

• Introspected.indexed()

getBeanMethods

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:

An immutable collection of methods.

findDeclaredMethod

public Optional<BeanMethod<T,Object>> findDeclaredMethod(String name,
 Class<?>... parameterTypes)

Description copied from interface: ReflectiveIntrospection

Finds the method the introspected type itself declares, with the annotations of that declaration only: the generated metadata of a method merges the annotations of the methods it overrides.

Specified by:

findDeclaredMethod in interface ReflectiveIntrospection<T>

Parameters:

name - The method name

parameterTypes - The parameter types

Returns:

The method declared by the type, empty when the type inherits it

getConstructorArguments

public Argument<?>[] getConstructorArguments()

Description copied from interface: BeanIntrospection

The constructor arguments needed to instantiate the bean.

Specified by:

getConstructorArguments in interface BeanIntrospection<T>

Returns:

An argument array

getConstructor

public BeanConstructor<T> getConstructor()

The generated constructor, with the metadata the reflection reads from the constructor when the generated one carries none: a generated introspection instantiates, it does not describe.

Specified by:

getConstructor in interface BeanIntrospection<T>

Returns:

The bean constructor.

getConstructors

public List<BeanConstructor<T>> getConstructors()

Description copied from interface: BeanIntrospection

Returns the constructors this introspection describes.

By default an introspection only describes the constructor used to instantiate beans, in which case this method returns a singleton list containing BeanIntrospection.getConstructor(). When the introspected type opts in via Introspected.constructors(), or by annotating individual constructors with io.micronaut.context.annotation.Executable, every described constructor is returned, including its own annotation metadata and the annotation metadata of its parameters.

A described constructor reports the parameters of its JVM signature, which for a non-static inner class means that BeanConstructor.getArguments() starts with the implicit enclosing instance, named this$0, exactly as Constructor.getParameterTypes() reports it. The enclosing instance must therefore be passed first to BeanConstructor.instantiate(Object...). BeanIntrospection.getConstructor() and BeanIntrospection.getConstructorArguments() keep the source level view and never describe it, so for a non-static inner class the first element of this list does not report the same arguments as BeanIntrospection.getConstructor().

Specified by:

getConstructors in interface BeanIntrospection<T>

Specified by:

getConstructors in interface ReflectiveIntrospection<T>

Returns:

Every constructor of the type, BeanIntrospection.getConstructor() first

getBeanProperties

public Collection<BeanProperty<T,Object>> getBeanProperties()

The generated properties, each with the type arguments the reflection reads from every member: the getter of an interface can declare Map<String, @NotBlank String> where the field is a plain Map<String, String>.

Specified by:

getBeanProperties in interface BeanIntrospection<T>

Returns:

An immutable collection of properties.

getBeanReadProperties

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

The read properties the generated introspection reports, each as it reports it, completed by the ones of a property it does not describe at all.

A generated introspection that legitimately reads nothing - a type written to and never read from - reads nothing here either: the reflective members of the type do not stand in for the properties it has none of.

Specified by:

getBeanReadProperties in interface BeanIntrospection<T>

Returns:

The read properties

getBeanWriteProperties

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

The write properties the generated introspection reports, each as it reports it, completed by the ones of a property it does not describe at all, the way getBeanReadProperties() completes the read ones.

Specified by:

getBeanWriteProperties in interface BeanIntrospection<T>

Returns:

The write properties

getProperty

public Optional<BeanProperty<T,Object>> getProperty(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

instantiate

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

Returns:

An instance

Throws:

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

instantiate

public T instantiate(boolean strictNullable,
 @Nullable 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.

isBuildable

public boolean isBuildable()

Description copied from interface: BeanIntrospection

Can the introspection be constructed with BeanIntrospection.builder().

Specified by:

isBuildable in interface BeanIntrospection<T>

Returns:

True if it can

hasBuilder

public boolean hasBuilder()

Description copied from interface: BeanIntrospection

Does the introspection have a backing builder.

This method exists so that consumers can choose to optimize towards direct instantiation using BeanIntrospection.instantiate() if no builder is present.

Specified by:

hasBuilder in interface BeanIntrospection<T>

Returns:

True if a backing builder is present.

builder

public BeanIntrospection.Builder<T> builder()

Specified by:

builder in interface BeanIntrospection<T>

Returns:

Obtain a builder for this introspection.

toString

public String toString()

Overrides:

toString in class Object