jodd.bean
Class BeanUtilBean

java.lang.Object
  jodd.bean.BeanUtilBean

public class BeanUtilBean
extends java.lang.Object

Instantiable version of BeanUtil.

Field Summary

static java.lang.String	THIS_REF
protected TypeConverterManagerBean	typeConverterManager

Constructor Summary

BeanUtilBean()

Method Summary

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	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	extracticGenericType(jodd.bean.BeanProperty bp, int index) Extracts generic parameter types.
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)
protected java.lang.Object	getField(java.lang.Object bean, java.lang.reflect.Field f) Return value of a field.
protected java.lang.Object	getIndexProperty(jodd.bean.BeanProperty bp, boolean suppressSecurity) Get non-nested property value: either simple or indexed property.
java.lang.Object	getIndexProperty(java.lang.Object bean, java.lang.String property, boolean suppressSecurity, boolean forced)
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)
protected java.lang.Object	getSimpleProperty(jodd.bean.BeanProperty bp, boolean suppressSecurity)
java.lang.Object	getSimpleProperty(java.lang.Object bean, java.lang.String property, boolean suppressSecurity) Reads simple property.
java.lang.Object	getSimplePropertyForced(java.lang.Object bean, java.lang.String property, boolean suppressSecurity) Reads simple property forced: when property value doesn't exist, it will be created.
boolean	hasDeclaredProperty(java.lang.Object bean, java.lang.String name)
protected boolean	hasIndexProperty(jodd.bean.BeanProperty bp, boolean suppressSecurity)
boolean	hasIndexProperty(java.lang.Object bean, java.lang.String property, boolean suppressSecurity)
boolean	hasProperty(java.lang.Object bean, java.lang.String name)
protected boolean	hasSimpleProperty(jodd.bean.BeanProperty bp, boolean suppressSecurity)
boolean	hasSimpleProperty(java.lang.Object bean, java.lang.String property, boolean suppressSecurity) Returns true if simple property exist.
protected int	indexOfDot(java.lang.String name) Finds the very first next dot.
protected java.lang.Object	invokeGetter(java.lang.Object bean, java.lang.reflect.Method m) Invokes getXxx() method of specified bean.
protected void	invokeSetter(java.lang.Object bean, java.lang.reflect.Method m, java.lang.Object value) Invokes setXxx() method with appropriate conversion if available.
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.
boolean	setDeclaredPropertyForcedSilent(java.lang.Object bean, java.lang.String name, java.lang.Object value) Silently sets declared Java Bean property forced.
boolean	setDeclaredPropertySilent(java.lang.Object bean, java.lang.String name, java.lang.Object value) Silently sets declared Java Bean property.
protected void	setField(java.lang.Object bean, java.lang.reflect.Field f, java.lang.Object value) Sets field value.
protected void	setIndexProperty(jodd.bean.BeanProperty bp, java.lang.Object value, boolean suppressSecurity) Sets indexed or regular properties (no nested!).
void	setIndexProperty(java.lang.Object bean, java.lang.String property, java.lang.Object value, boolean suppressSecurity, boolean forced)
void	setProperty(java.lang.Object bean, java.lang.String name, java.lang.Object value) Sets Java Bean property.
void	setPropertyForced(java.lang.Object bean, java.lang.String name, java.lang.Object value) Sets Java Bean property forced.
boolean	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.
boolean	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, boolean suppressSecurity) Sets a value of simple property.
void	setSimpleProperty(java.lang.Object bean, java.lang.String property, java.lang.Object value, boolean suppressSecurity)
void	setTypeConverterManager(TypeConverterManagerBean typeConverterManager) Sets custom type converter manager.

Methods inherited from class java.lang.Object

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

Field Detail

THIS_REF

public static final java.lang.String THIS_REF

See Also:

Constant Field Values

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 suppressSecurity)

Returns true if simple property exist.

hasSimpleProperty

protected boolean hasSimpleProperty(jodd.bean.BeanProperty bp,
                                    boolean suppressSecurity)

getSimpleProperty

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

Reads simple property.

getSimplePropertyForced

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

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

getSimpleProperty

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

setSimpleProperty

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

setSimpleProperty

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

Sets a value of simple property.

hasIndexProperty

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

hasIndexProperty

protected boolean hasIndexProperty(jodd.bean.BeanProperty bp,
                                   boolean suppressSecurity)

getIndexProperty

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

getIndexProperty

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

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 suppressSecurity,
                             boolean forced)

setIndexProperty

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

Sets indexed or regular properties (no nested!).

setProperty

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

Sets Java Bean property.

setPropertySilent

public boolean 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 boolean 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 boolean 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 boolean 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)

hasDeclaredProperty

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

getPropertyType

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

getDeclaredPropertyType

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

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.

setTypeConverterManager

public void setTypeConverterManager(TypeConverterManagerBean typeConverterManager)

Sets custom type converter manager.

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.

invokeSetter

protected void invokeSetter(java.lang.Object bean,
                            java.lang.reflect.Method m,
                            java.lang.Object value)

Invokes setXxx() method with appropriate conversion if available. It is assumed that all provided arguments are valid.

invokeGetter

protected java.lang.Object invokeGetter(java.lang.Object bean,
                                        java.lang.reflect.Method m)

Invokes getXxx() method of specified bean. It is assumed that all provided arguments are valid.

setField

protected void setField(java.lang.Object bean,
                        java.lang.reflect.Field f,
                        java.lang.Object value)

Sets field value.

getField

protected java.lang.Object getField(java.lang.Object bean,
                                    java.lang.reflect.Field f)

Return value of a field.

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.

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!

extracticGenericType

protected java.lang.Class extracticGenericType(jodd.bean.BeanProperty bp,
                                               int index)

Extracts generic parameter types.

extractType

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

Extracts type of current property.