io.micronaut.core.beans

Interface BeanIntrospection<T>

Type Parameters:

T - The bean type

All Superinterfaces:

AnnotationMetadata, AnnotationMetadataDelegate, AnnotationMetadataProvider, AnnotationSource

All Known Implementing Classes:

AbstractBeanIntrospection

@Immutable
public interface BeanIntrospection<T>
extends AnnotationMetadataDelegate

A BeanIntrospection is the result of compile time computation of a beans properties and annotation metadata.

This interface allows you to instantiate and read and write to bean properties without using reflection or caching reflective metadata, which is expensive from a memory consumption perspective.

BeanIntrospection instances can be obtained either via getIntrospection(Class) or via the BeanIntrospector.

A BeanIntrospection is only computed at compilation time if the class is annotated with Introspected.

Since:

1.1

Author:

graemerocher

See Also:

BeanIntrospector, Introspected

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

Method Summary

Modifier and Type	Method and Description
Collection<BeanProperty<T,Object>>	getBeanProperties()
Class<T>	getBeanType() The bean type.
default Argument<?>[]	getConstructorArguments() The constructor arguments needed to instantiate the bean.
Collection<BeanProperty<T,Object>>	getIndexedProperties(Class<? extends Annotation> annotationType) Get all the bean properties annotated for the given annotation type.
default Optional<BeanProperty<T,Object>>	getIndexedProperty(Class<? extends Annotation> annotationType) Get all the bean properties annotated for the given type.
Optional<BeanProperty<T,Object>>	getIndexedProperty(Class<? extends Annotation> annotationType, String annotationValue) Get all the bean properties annotated for the given type.
static <T2> BeanIntrospection<T2>	getIntrospection(Class<T2> type) Obtains an introspection from the default BeanIntrospector.
default Optional<BeanProperty<T,Object>>	getProperty(String name) Obtain a property by name.
default <P> Optional<BeanProperty<T,P>>	getProperty(String name, Class<P> type) Obtain a property by name and type.
default String[]	getPropertyNames() The property names as an array.
default <P> BeanProperty<T,P>	getRequiredProperty(String name, Class<P> type) Gets a property of the given name and type or throws IntrospectionException if the property is not present.
T	instantiate() Instantiates an instance of the bean, throwing an exception is instantiation is not possible.
T	instantiate(boolean strictNullable, Object... arguments) Instantiates an instance of the bean, throwing an exception is instantiation is not possible.
default T	instantiate(Object... arguments) Instantiates an instance of the bean, throwing an exception is instantiation is not possible.

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, findAnnotation, findAnnotation, findDeclaredAnnotation, findDeclaredAnnotation, getAnnotation, getAnnotation, getAnnotationNameByStereotype, getAnnotationNameByStereotype, getAnnotationNames, getAnnotationNamesByStereotype, getAnnotationNamesByStereotype, getAnnotationType, getAnnotationTypeByStereotype, getAnnotationTypeByStereotype, getAnnotationTypesByStereotype, getAnnotationValuesByType, getDeclaredAnnotation, getDeclaredAnnotation, getDeclaredAnnotationNameByStereotype, getDeclaredAnnotationNames, getDeclaredAnnotationNamesByStereotype, getDeclaredAnnotationTypeByStereotype, getDeclaredAnnotationTypeByStereotype, getDeclaredAnnotationValuesByType, getDefaultValue, getDefaultValue, getDefaultValue, getDefaultValue, getDefaultValues, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValue, getValues, getValues, hasAnnotation, hasAnnotation, hasDeclaredAnnotation, hasDeclaredAnnotation, hasDeclaredStereotype, hasDeclaredStereotype, hasDeclaredStereotype, hasStereotype, hasStereotype, hasStereotype, hasStereotype, intValue, intValue, intValue, isAnnotationPresent, isDeclaredAnnotationPresent, isEmpty, isFalse, isFalse, isPresent, isPresent, isTrue, isTrue, longValue, longValue, stringValue, stringValue, stringValue, stringValue, stringValues, stringValues, synthesize, synthesizeAll, synthesizeAnnotationsByType, synthesizeDeclared, synthesizeDeclared, synthesizeDeclaredAnnotationsByType

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

getAnnotationMetadata

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

hasSimpleAnnotation, hasSimpleDeclaredAnnotation

Method Detail

getBeanProperties

@Nonnull
Collection<BeanProperty<T,Object>> getBeanProperties()

Returns:

A immutable collection of properties.

getIndexedProperties

@Nonnull
Collection<BeanProperty<T,Object>> getIndexedProperties(@Nonnull
                                                                 Class<? extends Annotation> annotationType)

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.

Parameters:

annotationType - The annotation type

Returns:

A immutable collection of properties.

See Also:

Introspected.indexed()

instantiate

@Nonnull
T instantiate()
                throws InstantiationException

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

Returns:

An instance

Throws:

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

instantiate

@Nonnull
default T instantiate(Object... arguments)
                        throws InstantiationException

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

Parameters:

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

Returns:

An instance

Throws:

InstantiationException - If the bean cannot be instantiated.

instantiate

@Nonnull
T instantiate(boolean strictNullable,
                       Object... arguments)
                throws InstantiationException

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

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 getConstructorArguments()

Returns:

An instance

Throws:

InstantiationException - If the bean cannot be instantiated.

getBeanType

@Nonnull
Class<T> getBeanType()

The bean type.

Returns:

The bean type

getIndexedProperty

@Nonnull
Optional<BeanProperty<T,Object>> getIndexedProperty(@Nonnull
                                                             Class<? extends Annotation> annotationType,
                                                             @Nonnull
                                                             String annotationValue)

Get all the bean properties annotated for the given type.

Parameters:

annotationType - The annotation type

annotationValue - The annotation value

Returns:

A immutable collection of properties.

See Also:

Introspected.indexed()

getIndexedProperty

@Nonnull
default Optional<BeanProperty<T,Object>> getIndexedProperty(@Nonnull
                                                                     Class<? extends Annotation> annotationType)

Get all the bean properties annotated for the given type.

Parameters:

annotationType - The annotation type

Returns:

A immutable collection of properties.

See Also:

Introspected.indexed()

getConstructorArguments

@Nonnull
default Argument<?>[] getConstructorArguments()

The constructor arguments needed to instantiate the bean.

Returns:

An argument array

getProperty

@Nonnull
default Optional<BeanProperty<T,Object>> getProperty(@Nonnull
                                                              String name)

Obtain a property by name.

Parameters:

name - The name of the property

Returns:

A bean property if found

getRequiredProperty

@Nonnull
default <P> BeanProperty<T,P> getRequiredProperty(@Nonnull
                                                           String name,
                                                           @Nonnull
                                                           Class<P> type)

Gets a property of the given name and type or throws IntrospectionException if the property is not present.

Type Parameters:

P - The property generic type

Parameters:

name - The name

type - The type

Returns:

The property

getProperty

@Nonnull
default <P> Optional<BeanProperty<T,P>> getProperty(@Nonnull
                                                             String name,
                                                             @Nonnull
                                                             Class<P> type)

Obtain a property by name and type.

Type Parameters:

P - The property type

Parameters:

name - The name of the property

type - The property type to search for

Returns:

A bean property if found

getPropertyNames

@Nonnull
default String[] getPropertyNames()

The property names as an array.

Returns:

The properties names

getIntrospection

static <T2> BeanIntrospection<T2> getIntrospection(Class<T2> type)

Obtains an introspection from the default BeanIntrospector.

Type Parameters:

T2 - The generic type

Parameters:

type - The type

Returns:

The introspection

Throws:

IntrospectionException - If the introspection cannot be found or errors when loading