Package io.micronaut.core.beans

Class AbstractBeanProperty<B,P>

java.lang.Object

io.micronaut.core.beans.AbstractBeanProperty<B,P>

Type Parameters:

B - The bean type

P - The property type

All Implemented Interfaces:

AnnotatedElement, AnnotationMetadata, AnnotationMetadataDelegate, AnnotationMetadataProvider, AnnotationSource, BeanProperty<B,P>, BeanReadProperty<B,P>, BeanWriteProperty<B,P>, UnsafeBeanProperty<B,P>, UnsafeBeanReadProperty<B,P>, UnsafeBeanWriteProperty<B,P>, Named, ArgumentCoercible<P>

@Internal
public abstract class AbstractBeanProperty<B,P>
extends Object
implements UnsafeBeanProperty<B,P>

Abstract implementation of BeanProperty. Generated byte code should be used to create a subclass and implement the BeanProperty.get(Object) and BeanProperty.set(Object, Object) methods. 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 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	Description
protected	AbstractBeanProperty(@NonNull BeanIntrospection<B> introspection, @NonNull Class<P> type, @NonNull String name, @Nullable AnnotationMetadata annotationMetadata, @Nullable Argument[] typeArguments)	Default constructor.

Method Summary

Modifier and Type	Method	Description
@NonNull Argument<P>	asArgument()	Represent the type as an argument, including any generic type information.
boolean	equals(Object o)
final P	get(B bean)	Read the bean value.
AnnotationMetadata	getAnnotationMetadata()	Supplies the metadata.
final @NonNull BeanIntrospection<B>	getDeclaringBean()
@NonNull String	getName()
@NonNull Class<P>	getType()
final P	getUnsafe(B bean)	Unsafe version of BeanReadProperty.get(Object).
int	hashCode()
protected abstract P	readInternal(B bean)	Reads the bean property.
final void	set(B bean, P value)	Write the bean value.
final void	setUnsafe(B bean, P value)	Unsafe version of BeanWriteProperty.set(Object, Object).
String	toString()
B	withValue(B bean, P value)	This method will attempt to modify the property or if this is an immutable type using a copy constructor to return a new instance with the new value.
protected B	withValueInternal(B bean, P value)	Mutates a property value.
final B	withValueUnsafe(B bean, P value)	Unsafe version of BeanWriteProperty.withValue(Object, Object).
protected abstract void	writeInternal(B bean, P value)	Writes a property value.

Methods inherited from class java.lang.Object

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

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

isDeclaredNonNull, isDeclaredNullable, isNonNull, isNullable

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

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

Methods inherited from interface io.micronaut.core.annotation.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, 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.beans.BeanProperty

convertAndSet, get, get, get, get, getDeclaringType, hasSetterOrConstructorArgument, isReadOnly, isReadWrite, isWriteOnly

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

getDeclaringType

Constructor Details

AbstractBeanProperty

@Internal
protected AbstractBeanProperty(@NonNull
 @NonNull BeanIntrospection<B> introspection,
 @NonNull
 @NonNull Class<P> type,
 @NonNull
 @NonNull String name,
 @Nullable
 @Nullable AnnotationMetadata annotationMetadata,
 @Nullable
 @Nullable Argument[] typeArguments)

Default constructor.

Parameters:

introspection - The parent introspection

type - The property type

name - The property name

annotationMetadata - The annotation metadata

typeArguments - optional type arguments

Method Details

getName

@NonNull
public @NonNull String getName()

Specified by:

getName in interface Named

Returns:

The name of the component

getType

@NonNull
public @NonNull Class<P> getType()

Specified by:

getType in interface BeanProperty<B,P>

Specified by:

getType in interface BeanReadProperty<B,P>

Specified by:

getType in interface BeanWriteProperty<B,P>

Returns:

The property type.

asArgument

@NonNull
public @NonNull Argument<P> asArgument()

Description copied from interface: BeanWriteProperty

Represent the type as an argument, including any generic type information.

Specified by:

asArgument in interface ArgumentCoercible<B>

Specified by:

asArgument in interface BeanProperty<B,P>

Specified by:

asArgument in interface BeanReadProperty<B,P>

Specified by:

asArgument in interface BeanWriteProperty<B,P>

Returns:

The argument

getDeclaringBean

@NonNull
public final @NonNull BeanIntrospection<B> getDeclaringBean()

Specified by:

getDeclaringBean in interface BeanProperty<B,P>

Specified by:

getDeclaringBean in interface BeanReadProperty<B,P>

Specified by:

getDeclaringBean in interface BeanWriteProperty<B,P>

Returns:

The declaring bean introspection.

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

get

@Nullable
public final P get(@NonNull
 B bean)

Description copied from interface: BeanReadProperty

Read the bean value.

Specified by:

get in interface BeanProperty<B,P>

Specified by:

get in interface BeanReadProperty<B,P>

Parameters:

bean - The bean to read from

Returns:

The value

getUnsafe

public final P getUnsafe(B bean)

Description copied from interface: UnsafeBeanProperty

Unsafe version of BeanReadProperty.get(Object).

Specified by:

getUnsafe in interface UnsafeBeanProperty<B,P>

Specified by:

getUnsafe in interface UnsafeBeanReadProperty<B,P>

Parameters:

bean - The bean to read from

Returns:

The value

withValue

public B withValue(@NonNull
 B bean,
 @Nullable
 P value)

Description copied from interface: BeanWriteProperty

This method will attempt to modify the property or if this is an immutable type using a copy constructor to return a new instance with the new value.

This differs from BeanWriteProperty.set(Object, Object) which will throw an exception if the property does not have a setter.

• If the property is read-only but can be provided via constructor argument a new instance representing a copy of the bean is returned.
• If the property is mutable then the passed instance is returned and BeanWriteProperty.set(Object, Object) invoked to mutate the property
• If there is no way for the property to be mutated then an UnsupportedOperationException is thrown

Specified by:

withValue in interface BeanProperty<B,P>

Specified by:

withValue in interface BeanWriteProperty<B,P>

Parameters:

bean - The bean

value - The new value

Returns:

Either the existing instance or the property is mutable or a newly created instance via the copy constructor pattern.

withValueUnsafe

public final B withValueUnsafe(B bean,
 P value)

Description copied from interface: UnsafeBeanProperty

Unsafe version of BeanWriteProperty.withValue(Object, Object).

Specified by:

withValueUnsafe in interface UnsafeBeanProperty<B,P>

Specified by:

withValueUnsafe in interface UnsafeBeanWriteProperty<B,P>

Parameters:

bean - The bean

value - The new value

Returns:

Either the existing instance or the property is mutable or a newly created instance via the copy constructor pattern.

set

public final void set(@NonNull
 B bean,
 @Nullable
 P value)

Description copied from interface: BeanWriteProperty

Write the bean value.

Specified by:

set in interface BeanProperty<B,P>

Specified by:

set in interface BeanWriteProperty<B,P>

Parameters:

bean - The bean

value - The value to write

setUnsafe

public final void setUnsafe(B bean,
 P value)

Description copied from interface: UnsafeBeanProperty

Unsafe version of BeanWriteProperty.set(Object, Object).

Specified by:

setUnsafe in interface UnsafeBeanProperty<B,P>

Specified by:

setUnsafe in interface UnsafeBeanWriteProperty<B,P>

Parameters:

bean - The bean

value - The value to write

withValueInternal

@Internal
protected B withValueInternal(B bean,
 P value)

Mutates a property value.

Parameters:

bean - The bean

value - The value

Returns:

Either a copy of the bean with the copy constructor invoked or the mutated instance if it mutable

See Also:

• BeanProperty.withValue(Object, Object)

writeInternal

@Internal
protected abstract void writeInternal(@NonNull
 B bean,
 @Nullable
 P value)

Writes a property value.

Parameters:

bean - The bean

value - The value

readInternal

@Internal
protected abstract P readInternal(@NonNull
 B bean)

Reads the bean property.

Parameters:

bean - The bean

Returns:

THe 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