jodd.bean

Class BeanUtilBean

java.lang.Object

jodd.bean.BeanUtilBean

public class BeanUtilBean
extends java.lang.Object

Instantiable version of BeanUtil.

Field Summary

Fields

Modifier and Type	Field and Description
protected Introspector	introspector
protected TypeConverterManagerBean	typeConverterManager

Constructor Summary

Constructors

Constructor and Description
BeanUtilBean()

Method Summary

Modifier and Type	Method and Description
protected java.lang.Object	arrayForcedGet(jodd.bean.BeanProperty bp, java.lang.Object array, int index) Returns the element of an array forced.
protected void	arrayForcedSet(jodd.bean.BeanProperty bp, java.lang.Object array, int index, java.lang.Object value) Sets the array element forced.
protected java.lang.Object	convertIndexToMapKey(Getter getter, java.lang.Object index) Converts Map index to key type.
protected java.lang.Object	convertToCollection(java.lang.Object value, java.lang.Class destinationType, java.lang.Class componentType) Convert to collection.
protected java.lang.Object	convertType(java.lang.Object value, java.lang.Class type) Converts object to destination type.
protected java.lang.Object	createBeanProperty(jodd.bean.BeanProperty bp) Creates new instance for current property name through its setter.
protected java.lang.Object	ensureArraySize(jodd.bean.BeanProperty bp, java.lang.Object array, java.lang.Class componentType, int index)
protected void	ensureListSize(java.util.List list, int size)
protected java.lang.Class	extractGenericComponentType(Getter getter) Extracts generic component type of a property.
protected java.lang.String	extractIndex(jodd.bean.BeanProperty bp) Extract index string from non-nested property name.
java.lang.String	extractThisReference(java.lang.String propertyName) Extract the first name of this reference.
protected java.lang.Class	extractType(jodd.bean.BeanProperty bp) Extracts type of current property.
java.lang.Object	getDeclaredProperty(java.lang.Object bean, java.lang.String name) Returns value of declared bean's property.
java.lang.Object	getDeclaredPropertySilently(java.lang.Object bean, java.lang.String name) Silently returns value of declared bean's property.
java.lang.Class	getDeclaredPropertyType(java.lang.Object bean, java.lang.String name) Returns property type of declared property.
protected java.lang.Object	getIndexProperty(jodd.bean.BeanProperty bp) Get non-nested property value: either simple or indexed property.
java.lang.Object	getIndexProperty(java.lang.Object bean, java.lang.String property, boolean declared, boolean forced)
Introspector	getIntrospector() Returns introspector implementation.
java.lang.Object	getProperty(java.lang.Object bean, java.lang.String name) Returns value of bean's property.
java.lang.Object	getPropertySilently(java.lang.Object bean, java.lang.String name) Silently returns value of bean's property.
java.lang.Class	getPropertyType(java.lang.Object bean, java.lang.String name) Returns property type.
protected java.lang.Object	getSimpleProperty(jodd.bean.BeanProperty bp)
java.lang.Object	getSimpleProperty(java.lang.Object bean, java.lang.String property, boolean declared) Reads simple property.
java.lang.Object	getSimplePropertyForced(java.lang.Object bean, java.lang.String property, boolean declared) Reads simple property forced: when property value doesn't exist, it will be created.
TypeConverterManagerBean	getTypeConverterManager() Returns type converter manager implementation.
boolean	hasDeclaredProperty(java.lang.Object bean, java.lang.String name) Returns true if bean has a declared property.
boolean	hasDeclaredRootProperty(java.lang.Object bean, java.lang.String name) Returns true if bean has only a declared root property.
protected boolean	hasIndexProperty(jodd.bean.BeanProperty bp)
boolean	hasIndexProperty(java.lang.Object bean, java.lang.String property, boolean declared) Returns true if bean has indexed property.
boolean	hasProperty(java.lang.Object bean, java.lang.String name) Returns true if bean has a property.
boolean	hasRootProperty(java.lang.Object bean, java.lang.String name) Returns true if bean has only a root property.
protected boolean	hasSimpleProperty(jodd.bean.BeanProperty bp)
boolean	hasSimpleProperty(java.lang.Object bean, java.lang.String property, boolean declared) Returns true if simple property exist.
protected int	indexOfDot(java.lang.String name) Finds the very first next dot.
protected java.lang.Object	invokeSetter(Setter setter, jodd.bean.BeanProperty bp, java.lang.Object value) Invokes setter, but first converts type to match the setter type.
protected int	parseInt(java.lang.String indexString, jodd.bean.BeanProperty bp)
void	populateBean(java.lang.Object bean, java.util.Map<?,?> map) Populates bean from a Map.
void	populateProperty(java.lang.Object bean, java.lang.String name, java.util.List<?> list) Populates indexed bean property from a List.
void	populateProperty(java.lang.Object bean, java.lang.String name, java.util.Map<?,?> map) Populates simple bean property from a Map.
protected boolean	resolveExistingNestedProperties(jodd.bean.BeanProperty bp)
protected void	resolveNestedProperties(jodd.bean.BeanProperty bp) Resolves nested property name to the very last indexed property.
void	setDeclaredProperty(java.lang.Object bean, java.lang.String name, java.lang.Object value) Sets declared Java Bean property.
void	setDeclaredPropertyForced(java.lang.Object bean, java.lang.String name, java.lang.Object value) Sets declared Java Bean property forced.
void	setDeclaredPropertyForcedSilent(java.lang.Object bean, java.lang.String name, java.lang.Object value) Silently sets declared Java Bean property forced.
void	setDeclaredPropertySilent(java.lang.Object bean, java.lang.String name, java.lang.Object value) Silently sets declared Java Bean property.
protected void	setIndexProperty(jodd.bean.BeanProperty bp, java.lang.Object value) Sets indexed or regular properties (no nested!).
void	setIndexProperty(java.lang.Object bean, java.lang.String property, java.lang.Object value, boolean declared, boolean forced)
void	setIntrospector(Introspector introspector) Sets introspector implementation.
void	setProperty(java.lang.Object bean, java.lang.String name, java.lang.Object value) Sets Java Bean property.
void	setProperty(java.lang.Object bean, java.lang.String name, java.lang.Object value, boolean declared, boolean forced, boolean silent) Sets Java Bean property.
void	setPropertyForced(java.lang.Object bean, java.lang.String name, java.lang.Object value) Sets Java Bean property forced.
void	setPropertyForcedSilent(java.lang.Object bean, java.lang.String name, java.lang.Object value) Sets Java Bean property forced, without throwing an exception on non-existing properties.
void	setPropertySilent(java.lang.Object bean, java.lang.String name, java.lang.Object value) Sets Java Bean property silently, without throwing an exception on non-existing properties.
protected void	setSimpleProperty(jodd.bean.BeanProperty bp, java.lang.Object value) Sets a value of simple property.
void	setSimpleProperty(java.lang.Object bean, java.lang.String property, java.lang.Object value, boolean declared) Sets simple property.
void	setTypeConverterManager(TypeConverterManagerBean typeConverterManager) Sets type converter manager implementation.

Methods inherited from class java.lang.Object

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

Field Detail

introspector

protected Introspector introspector

typeConverterManager

protected TypeConverterManagerBean typeConverterManager

Constructor Detail

BeanUtilBean

public BeanUtilBean()

Method Detail

resolveNestedProperties

protected void resolveNestedProperties(jodd.bean.BeanProperty bp)

Resolves nested property name to the very last indexed property. If forced, null or non-existing properties will be created.

resolveExistingNestedProperties

protected boolean resolveExistingNestedProperties(jodd.bean.BeanProperty bp)

hasSimpleProperty

public boolean hasSimpleProperty(java.lang.Object bean,
                                 java.lang.String property,
                                 boolean declared)

Returns true if simple property exist.

hasSimpleProperty

protected boolean hasSimpleProperty(jodd.bean.BeanProperty bp)

getSimpleProperty

public java.lang.Object getSimpleProperty(java.lang.Object bean,
                                          java.lang.String property,
                                          boolean declared)

Reads simple property.

getSimplePropertyForced

public java.lang.Object getSimplePropertyForced(java.lang.Object bean,
                                                java.lang.String property,
                                                boolean declared)

Reads simple property forced: when property value doesn't exist, it will be created.

getSimpleProperty

protected java.lang.Object getSimpleProperty(jodd.bean.BeanProperty bp)

setSimpleProperty

public void setSimpleProperty(java.lang.Object bean,
                              java.lang.String property,
                              java.lang.Object value,
                              boolean declared)

Sets simple property.

setSimpleProperty

protected void setSimpleProperty(jodd.bean.BeanProperty bp,
                                 java.lang.Object value)

Sets a value of simple property.

hasIndexProperty

public boolean hasIndexProperty(java.lang.Object bean,
                                java.lang.String property,
                                boolean declared)

Returns true if bean has indexed property.

hasIndexProperty

protected boolean hasIndexProperty(jodd.bean.BeanProperty bp)

getIndexProperty

public java.lang.Object getIndexProperty(java.lang.Object bean,
                                         java.lang.String property,
                                         boolean declared,
                                         boolean forced)

getIndexProperty

protected java.lang.Object getIndexProperty(jodd.bean.BeanProperty bp)

Get non-nested property value: either simple or indexed property. If forced, missing bean will be created if possible.

setIndexProperty

public void setIndexProperty(java.lang.Object bean,
                             java.lang.String property,
                             java.lang.Object value,
                             boolean declared,
                             boolean forced)

setIndexProperty

protected void setIndexProperty(jodd.bean.BeanProperty bp,
                                java.lang.Object value)

Sets indexed or regular properties (no nested!).

setProperty

public void setProperty(java.lang.Object bean,
                        java.lang.String name,
                        java.lang.Object value,
                        boolean declared,
                        boolean forced,
                        boolean silent)

Sets Java Bean property.

Parameters:

bean - Java POJO bean or a Map

name - property name

value - property value

declared - consider declared properties as well

forced - force creation of missing values

silent - silent mode, no exception is thrown

setProperty

public void setProperty(java.lang.Object bean,
                        java.lang.String name,
                        java.lang.Object value)

Sets Java Bean property.

setPropertySilent

public void setPropertySilent(java.lang.Object bean,
                              java.lang.String name,
                              java.lang.Object value)

Sets Java Bean property silently, without throwing an exception on non-existing properties.

setPropertyForced

public void setPropertyForced(java.lang.Object bean,
                              java.lang.String name,
                              java.lang.Object value)

Sets Java Bean property forced.

setPropertyForcedSilent

public void setPropertyForcedSilent(java.lang.Object bean,
                                    java.lang.String name,
                                    java.lang.Object value)

Sets Java Bean property forced, without throwing an exception on non-existing properties.

setDeclaredProperty

public void setDeclaredProperty(java.lang.Object bean,
                                java.lang.String name,
                                java.lang.Object value)

Sets declared Java Bean property.

setDeclaredPropertySilent

public void setDeclaredPropertySilent(java.lang.Object bean,
                                      java.lang.String name,
                                      java.lang.Object value)

Silently sets declared Java Bean property.

setDeclaredPropertyForced

public void setDeclaredPropertyForced(java.lang.Object bean,
                                      java.lang.String name,
                                      java.lang.Object value)

Sets declared Java Bean property forced.

setDeclaredPropertyForcedSilent

public void setDeclaredPropertyForcedSilent(java.lang.Object bean,
                                            java.lang.String name,
                                            java.lang.Object value)

Silently sets declared Java Bean property forced.

getProperty

public java.lang.Object getProperty(java.lang.Object bean,
                                    java.lang.String name)

Returns value of bean's property.

getPropertySilently

public java.lang.Object getPropertySilently(java.lang.Object bean,
                                            java.lang.String name)

Silently returns value of bean's property. Return value null is ambiguous: it may means that property name is valid and property value is null or that property name is invalid.

getDeclaredProperty

public java.lang.Object getDeclaredProperty(java.lang.Object bean,
                                            java.lang.String name)

Returns value of declared bean's property.

getDeclaredPropertySilently

public java.lang.Object getDeclaredPropertySilently(java.lang.Object bean,
                                                    java.lang.String name)

Silently returns value of declared bean's property. Return value null is ambiguous: it may means that property name is valid and property value is null or that property name is invalid.

hasProperty

public boolean hasProperty(java.lang.Object bean,
                           java.lang.String name)

Returns true if bean has a property.

hasRootProperty

public boolean hasRootProperty(java.lang.Object bean,
                               java.lang.String name)

Returns true if bean has only a root property. If yes, this means that property may be injected into the bean. If not, bean does not contain the property.

hasDeclaredProperty

public boolean hasDeclaredProperty(java.lang.Object bean,
                                   java.lang.String name)

Returns true if bean has a declared property.

hasDeclaredRootProperty

public boolean hasDeclaredRootProperty(java.lang.Object bean,
                                       java.lang.String name)

Returns true if bean has only a declared root property. If yes, this means that property may be injected into the bean. If not, bean does not contain the property.

getPropertyType

public java.lang.Class getPropertyType(java.lang.Object bean,
                                       java.lang.String name)

Returns property type.

getDeclaredPropertyType

public java.lang.Class getDeclaredPropertyType(java.lang.Object bean,
                                               java.lang.String name)

Returns property type of declared property.

populateBean

public void populateBean(java.lang.Object bean,
                         java.util.Map<?,?> map)

Populates bean from a Map.

populateProperty

public void populateProperty(java.lang.Object bean,
                             java.lang.String name,
                             java.util.Map<?,?> map)

Populates simple bean property from a Map.

populateProperty

public void populateProperty(java.lang.Object bean,
                             java.lang.String name,
                             java.util.List<?> list)

Populates indexed bean property from a List.

extractThisReference

public java.lang.String extractThisReference(java.lang.String propertyName)

Extract the first name of this reference.

setIntrospector

public void setIntrospector(Introspector introspector)

Sets introspector implementation.

getIntrospector

public Introspector getIntrospector()

Returns introspector implementation.

setTypeConverterManager

public void setTypeConverterManager(TypeConverterManagerBean typeConverterManager)

Sets type converter manager implementation.

getTypeConverterManager

public TypeConverterManagerBean getTypeConverterManager()

Returns type converter manager implementation.

convertType

protected java.lang.Object convertType(java.lang.Object value,
                                       java.lang.Class type)

Converts object to destination type. Invoked before the value is set into destination. Throws TypeConversionException if conversion fails.

convertToCollection

protected java.lang.Object convertToCollection(java.lang.Object value,
                                               java.lang.Class destinationType,
                                               java.lang.Class componentType)

Convert to collection.

invokeSetter

protected java.lang.Object invokeSetter(Setter setter,
                                        jodd.bean.BeanProperty bp,
                                        java.lang.Object value)

Invokes setter, but first converts type to match the setter type.

arrayForcedGet

protected java.lang.Object arrayForcedGet(jodd.bean.BeanProperty bp,
                                          java.lang.Object array,
                                          int index)

Returns the element of an array forced. If value is null, it will be instantiated. If not the last part of indexed bean property, array will be expanded to the index if necessary.

arrayForcedSet

protected void arrayForcedSet(jodd.bean.BeanProperty bp,
                              java.lang.Object array,
                              int index,
                              java.lang.Object value)

Sets the array element forced. If index is greater then arrays length, array will be expanded to the index. If speed is critical, it is better to allocate an array with proper size before using this method.

ensureArraySize

protected java.lang.Object ensureArraySize(jodd.bean.BeanProperty bp,
                                           java.lang.Object array,
                                           java.lang.Class componentType,
                                           int index)

ensureListSize

protected void ensureListSize(java.util.List list,
                              int size)

indexOfDot

protected int indexOfDot(java.lang.String name)

Finds the very first next dot. Ignores dots between index brackets. Returns -1 when dot is not found.

extractIndex

protected java.lang.String extractIndex(jodd.bean.BeanProperty bp)

Extract index string from non-nested property name. If index is found, it is stripped from bean property name. If no index is found, it returns null.

parseInt

protected int parseInt(java.lang.String indexString,
                       jodd.bean.BeanProperty bp)

createBeanProperty

protected java.lang.Object createBeanProperty(jodd.bean.BeanProperty bp)

Creates new instance for current property name through its setter. It uses default constructor!

extractGenericComponentType

protected java.lang.Class extractGenericComponentType(Getter getter)

Extracts generic component type of a property. Returns Object.class when property does not have component.

convertIndexToMapKey

protected java.lang.Object convertIndexToMapKey(Getter getter,
                                                java.lang.Object index)

Converts Map index to key type. If conversion fails, original value will be returned.

extractType

protected java.lang.Class extractType(jodd.bean.BeanProperty bp)

Extracts type of current property.