org.joda.beans.impl

Class BasicBeanBuilder<T extends Bean>

java.lang.Object

org.joda.beans.impl.BasicBeanBuilder<T>

Type Parameters:

T - the bean type

All Implemented Interfaces:

BeanBuilder<T>

Direct Known Subclasses:

DirectBeanBuilder

public class BasicBeanBuilder<T extends Bean>
extends Object
implements BeanBuilder<T>

Basic implementation of BeanBuilder that wraps a real bean.

This approach saves creating a temporary map, but is only suitable if the bean has a no-arg constructor and allows properties to be set.

Constructor Summary

Constructors

Constructor and Description
BasicBeanBuilder(T bean) Constructs the builder wrapping the target bean.

Method Summary

Methods

Modifier and Type	Method and Description
T	build() Builds the bean from the state of the builder.
protected BeanBuilder<T>	get(String propertyName) Gets the current value of the property.
protected T	getTargetBean() Gets the target bean.
BeanBuilder<T>	set(MetaProperty<?> property, Object value) Sets the value of a single property into the builder.
BeanBuilder<T>	set(String propertyName, Object value) Sets the value of a single property into the builder.
BeanBuilder<T>	setAll(Map<String,? extends Object> propertyValueMap) Sets the value of a map of properties into the builder.
BeanBuilder<T>	setString(MetaProperty<?> property, String value) Sets the value of a single property into the builder.
BeanBuilder<T>	setString(String propertyName, String value) Sets the value of a single property into the builder.
String	toString() Returns a string that summarises the builder.
protected void	validate(T bean) Hook to allow a subclass to validate the bean.

Methods inherited from class java.lang.Object

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

Constructor Detail

BasicBeanBuilder

public BasicBeanBuilder(T bean)

Constructs the builder wrapping the target bean.

Parameters:

bean - the target bean, not null

Method Detail

getTargetBean

protected T getTargetBean()

Gets the target bean.

Returns:

the target bean, not null

get

protected BeanBuilder<T> get(String propertyName)

Gets the current value of the property.

Parameters:

propertyName - the property name, not null

Returns:

the current value in the builder, null if not found or value is null

set

public BeanBuilder<T> set(String propertyName,
                 Object value)

Description copied from interface: BeanBuilder

Sets the value of a single property into the builder.

This will normally behave as per a Map, however it may not and as a general rule callers should only set each property once.

Specified by:

set in interface BeanBuilder<T extends Bean>

Parameters:

propertyName - the property name, not null

value - the property value, may be null

Returns:

this, for chaining, not null

set

public BeanBuilder<T> set(MetaProperty<?> property,
                 Object value)

Description copied from interface: BeanBuilder

Sets the value of a single property into the builder.

This will normally behave as per a Map, however it may not and as a general rule callers should only set each property once.

Specified by:

set in interface BeanBuilder<T extends Bean>

Parameters:

property - the property, not null

value - the property value, may be null

Returns:

this, for chaining, not null

setString

public BeanBuilder<T> setString(String propertyName,
                       String value)

Description copied from interface: BeanBuilder

Sets the value of a single property into the builder.

This converts the string to the correct type for the property. Conversion uses Joda-Convert.

This will normally behave as per a Map, however it may not and as a general rule callers should only set each property once.

Specified by:

setString in interface BeanBuilder<T extends Bean>

Parameters:

propertyName - the property name, not null

value - the property value, may be null

Returns:

this, for chaining, not null

setString

public BeanBuilder<T> setString(MetaProperty<?> property,
                       String value)

Description copied from interface: BeanBuilder

Sets the value of a single property into the builder.

This converts the string to the correct type for the property. Conversion uses Joda-Convert.

This will normally behave as per a Map, however it may not and as a general rule callers should only set each property once.

Specified by:

setString in interface BeanBuilder<T extends Bean>

Parameters:

property - the property name, not null

value - the property value, may be null

Returns:

this, for chaining, not null

setAll

public BeanBuilder<T> setAll(Map<String,? extends Object> propertyValueMap)

Description copied from interface: BeanBuilder

Sets the value of a map of properties into the builder.

Each map entry is used as the input to BeanBuilder.set(String, Object).

This will normally behave as per a Map, however it may not and as a general rule callers should only set each property once.

Specified by:

setAll in interface BeanBuilder<T extends Bean>

Parameters:

propertyValueMap - the property name to value map, not null

Returns:

this, for chaining, not null

build

public T build()

Description copied from interface: BeanBuilder

Builds the bean from the state of the builder.

Once this method has been called, the builder is in an invalid state. The effect of further method calls is undetermined.

Specified by:

build in interface BeanBuilder<T extends Bean>

Returns:

the created bean, not null

validate

protected void validate(T bean)

Hook to allow a subclass to validate the bean.

Parameters:

bean - the bean to validate, not null

toString

public String toString()

Returns a string that summarises the builder.

Overrides:

toString in class Object

Returns:

a summary string, not null