Interface BeanProperty<B,T>

Type Parameters:
B - The bean type
T - The bean property type
All Superinterfaces:
AnnotatedElement, AnnotationMetadata, AnnotationMetadataDelegate, AnnotationMetadataProvider, AnnotationSource, ArgumentCoercible<T>, Named
All Known Subinterfaces:
UnsafeBeanProperty<B,T>
All Known Implementing Classes:
AbstractBeanProperty

public interface BeanProperty<B,T> extends AnnotatedElement, AnnotationMetadataDelegate, ArgumentCoercible<T>
Represents a bean property and associated annotation metadata.

A BeanProperty allows you to read the value of a property via get(Object) or write to it via set(Object, Object), without using reflection.

The annotations of a property can be inspected via the AnnotationMetadataProvider.getAnnotationMetadata() method.

Since:
1.1
Author:
graemerocher
See Also:
  • Method Details

    • getDeclaringBean

      @NonNull @NonNull BeanIntrospection<B> getDeclaringBean()
      Returns:
      The declaring bean introspection.
    • get

      @Nullable T get(@NonNull B bean)
      Read the bean value.
      Parameters:
      bean - The bean to read from
      Returns:
      The value
      Throws:
      IllegalArgumentException - If the bean instance if not of the correct type
    • get

      @NonNull default <T2> @NonNull Optional<T2> get(@NonNull B bean, @NonNull @NonNull Class<T2> type)
      Read the value and try to convert it to the given type.
      Type Parameters:
      T2 - The generic type
      Parameters:
      bean - The bean
      type - The type
      Returns:
      The value if conversion was possible.
    • get

      default <T2> Optional<T2> get(@NonNull B bean, @NonNull @NonNull Argument<T2> argument)
      Read the value and try to convert it to the given type.
      Type Parameters:
      T2 - The generic type
      Parameters:
      bean - The bean
      argument - The type
      Returns:
      The value if conversion was possible.
    • get

      default <T2> Optional<T2> get(@NonNull B bean, @NonNull @NonNull ArgumentConversionContext<T2> conversionContext)
      Read the value and try to convert it to the given type.
      Type Parameters:
      T2 - The generic type
      Parameters:
      bean - The bean
      conversionContext - The conversion context to use
      Returns:
      The value if conversion was possible.
    • get

      @Nullable default <T2> T2 get(@NonNull B bean, @NonNull @NonNull Class<T2> type, @Nullable T2 defaultValue)
      Read the value and try to convert it to the given type.
      Type Parameters:
      T2 - The generic type
      Parameters:
      bean - The bean
      type - The type
      defaultValue - The default value if conversion is not possible
      Returns:
      The value if conversion was possible.
    • hasSetterOrConstructorArgument

      default boolean hasSetterOrConstructorArgument()
      This method returns true if the property can be mutated either via copy constructor or bean setter.
      Returns:
      True if it is mutable
      Since:
      2.3.0
      See Also:
    • withValue

      default B withValue(@NonNull B bean, @Nullable T 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.

      This differs from 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 set(Object, Object) invoked to mutate the property
      • If there is no way for the property to be mutated then an UnsupportedOperationException is thrown
      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.
      Throws:
      UnsupportedOperationException - if the property cannot be mutated
      Since:
      2.3.0
    • set

      default void set(@NonNull B bean, @Nullable T value)
      Write the bean value.
      Parameters:
      bean - The bean
      value - The value to write
      Throws:
      IllegalArgumentException - If either the bean type or value type are not correct
    • convertAndSet

      default void convertAndSet(@NonNull B bean, @Nullable @Nullable Object value)
      Convert the value and set if on the bean using the default conversion service.
      Parameters:
      bean - The bean
      value - The value
      Throws:
      ConversionErrorException - If the value couldn't be converted
    • getType

      @NonNull @NonNull Class<T> getType()
      Returns:
      The property type.
    • asArgument

      @NonNull default @NonNull Argument<T> asArgument()
      Represent the type as an argument, including any generic type information.
      Specified by:
      asArgument in interface ArgumentCoercible<B>
      Returns:
      The argument
    • isReadOnly

      default boolean isReadOnly()
      Returns:
      Whether the property is read-only
    • isWriteOnly

      default boolean isWriteOnly()
      Returns:
      Whether the property is write-only
    • isReadWrite

      default boolean isReadWrite()
      Whether the property can be written to and read from.
      Returns:
      True if it can.
    • getDeclaringType

      default Class<B> getDeclaringType()
      The declaring type of the property.
      Returns:
      The type