net.sf.juffrou.reflect

Class JuffrouBeanWrapper

java.lang.Object

net.sf.juffrou.reflect.JuffrouBeanWrapper

public class JuffrouBeanWrapper
extends Object

Bean handling through property names.

Allows access to the wrapped bean's properties and also to the properties of beans referenced by them. For example the property path "pro1.prop2" will access the property prop2 from the nested bean referenced by prop1.
This bean wrapper auto grows nested paths, so for each nested bean referenced in this manner, a nested bean wrapper is automatically created. In the previous example, a bean wrapper would be created for the bean referenced by property prop1. The nested bean wrappers can be obtained by calling the getNestesWrappers() method.
You can reference nested properties as deep as you like as long as the bean path exists.

Author:

cemartins

Constructor Summary

Constructors

Constructor and Description
JuffrouBeanWrapper(BeanWrapperContext context) Construct a bean wrapper using the metadata and preferences of an existing BeanWrapperContext. Performance is better, because there is no need to do introspection.
JuffrouBeanWrapper(BeanWrapperContext context, JuffrouBeanWrapper parentBeanWrapper, String parentBeanProperty)
JuffrouBeanWrapper(BeanWrapperContext context, Object instance) Construct a bean wrapper using the metadata and preferences of an existing BeanWrapperContext and initializes it with an instance value. Performance is better, because there is no need to do introspection.
JuffrouBeanWrapper(Class<?> clazz) Construct a bean wrapper around a class.
JuffrouBeanWrapper(Object instance) Construct a bean wrapper around an existing bean instance. This constructor will have to create a BeanWrapperContext to get introspection metadata.

Method Summary

Modifier and Type	Method and Description
Object	getBean() Get the wrapped bean instance.
Object	getBean(boolean instantiateIfNull) Get the wrapped bean Get the wrapped bean instance.
Class<?>	getBeanClass() Get the wrapped bean class
Class<?>	getClazz(String propertyName) Gets the class of a property in the wrapped bean.
BeanWrapperContext	getContext()
BeanWrapperFactory	getFactory()
Field	getField(String propertyName) Gets the field of a property in the wrapped bean.
JuffrouBeanWrapper	getLocalNestedWrapper(String thisProperty) Obtains the BeanWrapper that corresponds to the bean instance of this property type.
JuffrouBeanWrapper	getNestedWrapper(String propertyName) Obtains the JuffrouBeanWrapper corresponding to the bean referred by propertyName.
Map<String,JuffrouBeanWrapper>	getNestedWrappers() Returns all the nested bean wrappers that have been created inside this bean wrapper. Nested bean wrappers are created when you access a nested property (i.e.
protected String	getParentBeanProperty()
protected JuffrouBeanWrapper	getParentBeanWrapper()
String[]	getPropertyNames() Get the names of all properties found in this bean and base ascending hierarchy
Type	getType(String propertyName) Gets the type of a property in the wrapped bean.
Type[]	getTypeArguments(String propertyName) Gets the type arguments of a property in the wrapped bean.
Object	getValue(String propertyName) Gets the value of a property in the wrapped bean.
boolean	hasProperty(String propertyName) Checks whether a property exists in the wrapped bean.
void	setBean(Object bean) Replaces the wrapped bean with another instance of the same type
void	setValue(String propertyName, Object value) Sets the value of a property in the wrapped bean.
void	setValueOfString(String propertyName, String value) Same as setValue(String propertyName, Object value) but the value will be converted from String to whatever type the property referenced by propertyName is.
String	toString() Returns the string representation of the wrapped bean instance, or and empty string if the instance is null.

Methods inherited from class java.lang.Object

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

Constructor Detail

JuffrouBeanWrapper

public JuffrouBeanWrapper(BeanWrapperContext context)

Construct a bean wrapper using the metadata and preferences of an existing BeanWrapperContext.
Performance is better, because there is no need to do introspection.

Parameters:

context - metadata information about the class to instantiate the wrapped bean

JuffrouBeanWrapper

public JuffrouBeanWrapper(BeanWrapperContext context,
                          Object instance)

Construct a bean wrapper using the metadata and preferences of an existing BeanWrapperContext and initializes it with an instance value.
Performance is better, because there is no need to do introspection.

Parameters:

context - metadata and preferences information about the class

instance - bean instance

JuffrouBeanWrapper

public JuffrouBeanWrapper(BeanWrapperContext context,
                          JuffrouBeanWrapper parentBeanWrapper,
                          String parentBeanProperty)

JuffrouBeanWrapper

public JuffrouBeanWrapper(Object instance)

Construct a bean wrapper around an existing bean instance.
This constructor will have to create a BeanWrapperContext to get introspection metadata. You can use JuffrouBeanWrapper(BeanWrapperContext, Object) instead.

Parameters:

instance -

JuffrouBeanWrapper

public JuffrouBeanWrapper(Class<?> clazz)

Construct a bean wrapper around a class. Bean instances will be instances of that class.
This constructor will have to create a BeanWrapperContext to get introspection metadata. You can use JuffrouBeanWrapper(BeanWrapperContext, Object) instead.

Parameters:

clazz - class to instantiate the wrapped bean

Method Detail

getContext

public BeanWrapperContext getContext()

Returns:

the BeanWrapperContext containing introspection information about this bean

getFactory

public BeanWrapperFactory getFactory()

Returns:

The BeanWrapperFactory responsible for creating and caching the BeanWrapperContext for this bean and all its nested beans.

getBean

public Object getBean(boolean instantiateIfNull)

Get the wrapped bean Get the wrapped bean instance. If the wrapped instance is null, this method may instantiate it before returning.

Parameters:

instantiateIfNull - is true, this method will force the instantiation of the bean in case it is null.

Returns:

The wrapped bean instance or null.

getBean

public Object getBean()

Get the wrapped bean instance. This method will always return a non null value. If the instance is null it will be instantiated.
This is the same as getBean(boolean) with TRUE passed as parameter.

Returns:

the wrapped bean

See Also:

getBean(boolean)

setBean

public void setBean(Object bean)

Replaces the wrapped bean with another instance of the same type

Parameters:

bean - instance of the new bean to wrap

Throws:

InvalidParameterException - if the new bean is not of the same type of the initially wrapped bean.

getBeanClass

public Class<?> getBeanClass()

Get the wrapped bean class

Returns:

the class of the wrapped object

getNestedWrappers

public Map<String,JuffrouBeanWrapper> getNestedWrappers()

Returns all the nested bean wrappers that have been created inside this bean wrapper.
Nested bean wrappers are created when you access a nested property (i.e. getValue("prop1.prop2"))

Returns:

a Map where the keys are property names and the values are bean wrappers

hasProperty

public boolean hasProperty(String propertyName)

Checks whether a property exists in the wrapped bean. If that property references another bean (a nested bean) the method verifies if the property of the nested bean also exists.
For example hasProperty("pro1.prop2") returns true only if prop1 exists is this bean and prop2 exists in the bean referenced by prop1.
For each nested bean referenced in this manner, a nested bean wrapper is automatically created. In the previous example, a bean wrapper would be created for the bean referenced by property prop1.

Parameters:

propertyName - property name to search for

Returns:

true if the bean has a property with the specified property name

getPropertyNames

public String[] getPropertyNames()

Get the names of all properties found in this bean and base ascending hierarchy

Returns:

unordered list of property names.

toString

public String toString()

Returns the string representation of the wrapped bean instance, or and empty string if the instance is null.

Overrides:

toString in class Object

See Also:

Object.toString()

getValue

public Object getValue(String propertyName)

Gets the value of a property in the wrapped bean. If that property references another bean (a nested bean) Its property values can also be obtained by specifying a property path.
For example getValue("pro1.prop2") will get the value of prop2 from the nested bean referenced by prop1.
For each nested bean referenced in this manner, a nested bean wrapper is automatically created. In the previous example, a bean wrapper would be created for the bean referenced by property prop1.

Parameters:

propertyName -

Returns:

the value held in the bean property

getClazz

public Class<?> getClazz(String propertyName)

Gets the class of a property in the wrapped bean. If that property references another bean (a nested bean) Its property types can also be obtained by specifying a property path.
For example getType("pro1.prop2") will get the type of prop2 from the nested bean referenced by prop1.
For each nested bean referenced in this manner, a nested bean wrapper is automatically created. In the previous example, a bean wrapper would be created for the bean referenced by property prop1.

Parameters:

propertyName - the property name to search

Returns:

the class of the object referenced by the specified property

getType

public Type getType(String propertyName)

Gets the type of a property in the wrapped bean. If that property references another bean (a nested bean) Its property types can also be obtained by specifying a property path.
For example getType("pro1.prop2") will get the type of prop2 from the nested bean referenced by prop1.
For each nested bean referenced in this manner, a nested bean wrapper is automatically created. In the previous example, a bean wrapper would be created for the bean referenced by property prop1.

Parameters:

propertyName - the property name

Returns:

the type of the object referenced by the specified property

getTypeArguments

public Type[] getTypeArguments(String propertyName)

Gets the type arguments of a property in the wrapped bean. If that property references another bean (a nested bean) Its property types can also be obtained by specifying a property path.
For example getTypeArguments("pro1.prop2") will get the type arguments of prop2 from the nested bean referenced by prop1.
For each nested bean referenced in this manner, a nested bean wrapper is automatically created. In the previous example, a bean wrapper would be created for the bean referenced by property prop1.

Parameters:

propertyName - the property name

Returns:

an array of types

getField

public Field getField(String propertyName)

Gets the field of a property in the wrapped bean. If that property references another bean (a nested bean) Its property field can also be obtained by specifying a property path.
For example getField("pro1.prop2") will get the field of prop2 from the nested bean referenced by prop1.
For each nested bean referenced in this manner, a nested bean wrapper is automatically created. In the previous example, a bean wrapper would be created for the bean referenced by property prop1.

Parameters:

propertyName - the property

Returns:

the field which represents the specified bean property

setValueOfString

public void setValueOfString(String propertyName,
                             String value)

Same as setValue(String propertyName, Object value) but the value will be converted from String to whatever type the property referenced by propertyName is.

Parameters:

propertyName -

value - String representation of the value to be set

setValue

public void setValue(String propertyName,
                     Object value)

Sets the value of a property in the wrapped bean. If that property references another bean (a nested bean) Its property values can also be set by specifying a property path.
For example setValue("pro1.prop2", Boolean.TRUE) will set the value of prop2 from the nested bean referenced by prop1. If the value of prop1 was originally null, it would also be set to reference the new bean holding the value of prop2
For each nested bean referenced in this manner, a nested bean wrapper is automatically created. In the previous example, a bean wrapper would be created for the bean referenced by property prop1.

Parameters:

propertyName -

value - value to be set

getNestedWrapper

public JuffrouBeanWrapper getNestedWrapper(String propertyName)

Obtains the JuffrouBeanWrapper corresponding to the bean referred by propertyName. If that property references a nested bean, the method will delegate to that nested bean.
For example getNestedWrapper("prop1.prop2") will ask the bean wrapper on prop1 to return the bean wrapper of prop2. If the value of prop1 was originally null, it would also be set to reference the new bean holding the value of prop2
For each nested bean referenced in this manner, a nested bean wrapper is automatically created. In the previous example, a bean wrapper would be created for the bean referenced by property prop1.

Parameters:

propertyName - property name in this bean wrapper or inside a nested bean. It must be of bean type.

Returns:

JuffrouBeanWrapper instance

See Also:

to obtain a bean wrapper corresponding to a non nested property.

getLocalNestedWrapper

public JuffrouBeanWrapper getLocalNestedWrapper(String thisProperty)

Obtains the BeanWrapper that corresponds to the bean instance of this property type.

Parameters:

thisProperty - property name in this bean wrapper. The property type must be another bean and nested properties are not allowed.

Returns:

JuffrouBeanWrapper instance

See Also:

to obtain nested wrappers of nested wrappers.

getParentBeanWrapper

protected JuffrouBeanWrapper getParentBeanWrapper()

getParentBeanProperty

protected String getParentBeanProperty()