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
java.util.Collection<BeanProperty<T,java.lang.Object>>	getBeanProperties()
java.lang.Class<T>	getBeanType() The bean type.
default Argument<?>[]	getConstructorArguments() The constructor arguments needed to instantiate the bean.
java.util.Collection<BeanProperty<T,java.lang.Object>>	getIndexedProperties(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Get all the bean properties annotated for the given annotation type.
default java.util.Optional<BeanProperty<T,java.lang.Object>>	getIndexedProperty(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Get all the bean properties annotated for the given type.
java.util.Optional<BeanProperty<T,java.lang.Object>>	getIndexedProperty(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType, java.lang.String annotationValue) Get all the bean properties annotated for the given type.
static <T2> BeanIntrospection<T2>	getIntrospection(java.lang.Class<T2> type) Obtains an introspection from the default BeanIntrospector.
default java.util.Optional<BeanProperty<T,java.lang.Object>>	getProperty(java.lang.String name) Obtain a property by name.
default <P> java.util.Optional<BeanProperty<T,P>>	getProperty(java.lang.String name, java.lang.Class<P> type) Obtain a property by name and type.
default java.lang.String[]	getPropertyNames() The property names as an array.
default <P> BeanProperty<T,P>	getRequiredProperty(java.lang.String name, java.lang.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, java.lang.Object... arguments) Instantiates an instance of the bean, throwing an exception is instantiation is not possible.
default T	instantiate(java.lang.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, enumValues, enumValues, enumValues, enumValues, 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, hasSimpleAnnotation, hasSimpleDeclaredAnnotation, 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

Method Detail

getBeanProperties

@NonNull
java.util.Collection<BeanProperty<T,java.lang.Object>> getBeanProperties()

Returns:

A immutable collection of properties.

getIndexedProperties

@NonNull
java.util.Collection<BeanProperty<T,java.lang.Object>> getIndexedProperties(@NonNull
                                                                                     java.lang.Class<? extends java.lang.annotation.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(java.lang.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,
                       java.lang.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
java.lang.Class<T> getBeanType()

The bean type.

Returns:

The bean type

getIndexedProperty

@NonNull
java.util.Optional<BeanProperty<T,java.lang.Object>> getIndexedProperty(@NonNull
                                                                                 java.lang.Class<? extends java.lang.annotation.Annotation> annotationType,
                                                                                 @NonNull
                                                                                 java.lang.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 java.util.Optional<BeanProperty<T,java.lang.Object>> getIndexedProperty(@NonNull
                                                                                         java.lang.Class<? extends java.lang.annotation.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 java.util.Optional<BeanProperty<T,java.lang.Object>> getProperty(@NonNull
                                                                                  java.lang.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
                                                           java.lang.String name,
                                                           @NonNull
                                                           java.lang.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> java.util.Optional<BeanProperty<T,P>> getProperty(@NonNull
                                                                       java.lang.String name,
                                                                       @NonNull
                                                                       java.lang.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 java.lang.String[] getPropertyNames()

The property names as an array.

Returns:

The properties names

getIntrospection

static <T2> BeanIntrospection<T2> getIntrospection(java.lang.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