net.gdface.bean

类 BeanPropertySupport

java.lang.Object

net.gdface.bean.BeanPropertySupport

直接已知子类:

BeanPropertySupportImpl, BeanPropertySupportImpl

public abstract class BeanPropertySupport
extends java.lang.Object

参照 common-beanutils org.apache.commons.beanutils.PropertyUtilsBean 实现 Java Bean 的多级嵌套读写， 扩展支持Map,类成员，JSON String(需要JSON库[fastjson or jackson]支持) ,并提供自定义 PropertyDescriptor 支持

从以下版本开始:

2.7.0

作者:

guyadong

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	BeanPropertySupport.DiffNode
protected class	BeanPropertySupport.ReadVisitor 读访问接口实现
protected class	BeanPropertySupport.WriteVisitor 写访问接口实现

字段概要

字段

限定符和类型	字段和说明
static BeanPropertySupport	BEAN_SUPPORT
protected static java.lang.Object[]	EMPTY_OBJECT_ARRAY An empty object array
protected static boolean	traceEnabled

构造器概要

构造器

限定符	构造器和说明
protected	BeanPropertySupport()

方法概要

限定符和类型	方法和说明
static boolean	allEmpty(java.lang.Iterable<java.lang.Object> values) 判断输入参数是否都为空
static boolean	allEmpty(java.lang.Object... values) 判断输入参数是否都为空
void	checkCycleReference(java.lang.Object bean) 检查是否有循环引用,有则抛出异常
abstract void	clearDescriptors() Clear any cached property descriptors information for all classes loaded by any class loaders.
abstract void	copyProperties(java.lang.Object dest, java.lang.Object orig) Copy property values from the "origin" bean to the "destination" bean for all cases where the property names are the same (even though the actual getter and setter methods might have been customized via BeanInfo classes).
<T> BeanDifference	createBeanDifference(com.google.common.base.Function<T,java.lang.Object> rightGetter)
java.util.Map<java.lang.String,java.lang.Object>	describe(java.lang.Object bean) 以嵌套节点方式输出指定对象所有字段内容
java.util.Map<java.lang.String,java.lang.Object>	describe(java.lang.Object bean, boolean throwOnCycleReference) 以嵌套节点方式输出指定对象所有字段内容
java.util.Map<java.lang.String,BeanPropertySupport.DiffNode>	different(java.lang.Object left, java.lang.Object right) 返回两个对象之间差异的字段
java.util.Map<java.lang.String,BeanPropertySupport.DiffNode>	different(java.lang.Object left, java.lang.Object right, java.lang.Iterable<java.lang.String> focusNames) 返回两个对象之间差异的字段
java.util.Map<java.lang.String,BeanPropertySupport.DiffNode>	different(java.lang.Object left, java.lang.Object right, com.google.common.base.Predicate<java.lang.String> originNameFilter, java.lang.Iterable<java.lang.String> focusNames) 返回两个对象之间差异的字段
java.util.Map<java.lang.String,BeanPropertySupport.DiffNode>	different(java.lang.Object left, java.lang.Object right, com.google.common.base.Predicate<java.lang.String> originNameFilter, java.lang.Iterable<java.lang.String> forceExcludeNames, java.lang.Iterable<java.lang.String> focusNames, boolean includeRequired) 返回两个对象之间差异的字段，返回不同的字段差异信息
java.util.Map<java.lang.String,BeanPropertySupport.DiffNode>	different(java.lang.Object left, java.lang.Object right, com.google.common.base.Predicate<java.lang.String> originNameFilter, java.lang.String... focusNames) 返回两个对象之间差异的字段
java.util.Map<java.lang.String,BeanPropertySupport.DiffNode>	different(java.lang.Object left, java.lang.Object right, com.google.common.base.Predicate<java.lang.String> originNameFilter, java.lang.String[] forceExcludeNames, boolean includeRequired, java.lang.String... focusNames) 返回两个对象之间差异的字段，返回不同的字段差异信息
java.util.Map<java.lang.String,BeanPropertySupport.DiffNode>	different(java.lang.Object left, java.lang.Object right, java.lang.String... focusNames) 返回两个对象之间差异的字段
java.util.Map<java.lang.String,BeanPropertySupport.DiffNode>	different(java.lang.Object left, java.lang.Object right, java.lang.String focusNames) 返回两个对象之间差异的字段
protected java.lang.Object	getIndexedProperty(java.lang.Object bean, java.lang.String name) Return the value of the specified indexed property of the specified bean, with no type conversions.
protected abstract java.lang.Object	getIndexedProperty(java.lang.Object bean, java.lang.String name, int index) Return the value of the specified indexed property of the specified bean, with no type conversions.
protected java.lang.Object	getIndexValue(java.lang.String name, java.lang.Object bean, int index) 返回List对象索引指定位置的值 index为-1时返回列表第一个元素，等同于0, index为-2时返回列表最后一个元素,
protected java.lang.Object	getMappedProperty(java.lang.Object bean, java.lang.String name) Return the value of the specified mapped property of the specified bean, with no type conversions.
protected abstract java.lang.Object	getMappedProperty(java.lang.Object bean, java.lang.String name, java.lang.String key) Return the value of the specified mapped property of the specified bean, with no type conversions.
java.lang.Object	getProperty(java.lang.Object bean, java.lang.String name) Return the value of the (possibly nested) property of the specified name, for the specified bean, with no type conversions.
java.lang.Object	getProperty(java.lang.Object bean, java.lang.String name, java.lang.Object defaultValue) Return the value of the (possibly nested) property of the specified name, for the specified bean, with no type conversions.
protected java.lang.Object	getProperty0(java.lang.Object bean, java.lang.String name)
java.lang.Object	getPropertyChecked(java.lang.Object bean, java.lang.String name) Return the value of the (possibly nested) property of the specified name, for the specified bean, with no type conversions.
<T> T	getPropertyCheckType(java.lang.Object bean, java.lang.String name, java.lang.Class<T> targetType) Return the value of the (possibly nested) property of the specified name, for the specified bean, cast to target type.if value is String,try to parse json to target type.
abstract java.util.Set<java.lang.String>	getPropertyNames(java.lang.Class<?> beanClass, int rw, boolean lenient) 获取beanClass中所有具有指定读写类型(rw)的属性名集合
java.util.Set<java.lang.String>	getPropertyNames(java.lang.Object bean, int rw, boolean lenient)
protected java.lang.Object	getSearchedProperty(java.lang.Object bean, java.lang.String name) Return the value of the specified indexed property of the specified bean, with no type conversions.
protected abstract java.lang.Object	getSearchedProperty(java.lang.Object bean, java.lang.String name, java.lang.String field, java.lang.Object conditionValue) Return the value of the specified indexed property of the specified bean, with no type conversions.
protected abstract java.lang.Object	getSimpleProperty(java.lang.Object bean, java.lang.String name) Return the value of the specified simple property of the specified bean, with no type conversions.
boolean	hasCycleReference(java.lang.Object bean) 检查是否有循环引用,如果有循环引用返回true否则返回false
static boolean	hasEmpty(java.lang.Iterable<java.lang.Object> values) 判断输入参数是否有为空的元素
static boolean	hasEmpty(java.lang.Object... values) 判断输入参数是否有为空的元素
static boolean	isEmpty(boolean all, java.lang.Iterable<java.lang.Object> values) 判断输入参数是否都为空或有元素为空 如果all为true判断都为空,即values中的所有元素都为空时返回true 否则判断有空,即 values中的任一元素为空时就返回true, values为空则返回true
static boolean	isEmpty(boolean all, java.lang.Object... values) 判断输入参数是否都为空或有元素为空 如果all为true判断都为空,即values中的所有元素都为空时返回true 否则判断有空,即 values中的任一元素为空时就返回true, values为空则返回true
static boolean	isEmpty(java.lang.Object value) 判断输入参数是否为null或空 如果输入参数为@String,Collection,Iterable,Iterator,Map,数组类型则返回其是否为空, 否则返回false
abstract boolean	isReadable(java.lang.Object bean, java.lang.String name) Return true if the specified property name identifies a readable property on the specified bean; otherwise, return false.
abstract boolean	isWriteable(java.lang.Object bean, java.lang.String name) Return true if the specified property name identifies a writeable property on the specified bean; otherwise, return false.
protected static int	maybeJsonString(java.lang.Object object) 判断对象是否有可能是JSON 字符串, 如果是String类型且前后以{}返回1 如果是String类型且前后以[]返回2 否则返回0
protected java.lang.Object	searchIn(java.lang.Object input, java.lang.String field, java.lang.Object conditionValue) 在input中遍历所有元素找到匹配的值,没找到返回null
protected abstract void	setIndexedProperty(java.lang.Object bean, java.lang.String name, int index, java.lang.Object value) Set the value of the specified indexed property of the specified bean, with no type conversions.
protected void	setIndexedProperty(java.lang.Object bean, java.lang.String name, java.lang.Object value) Set the value of the specified indexed property of the specified bean, with no type conversions.
protected void	setMappedProperty(java.lang.Object bean, java.lang.String name, java.lang.Object value) Set the value of the specified mapped property of the specified bean, with no type conversions.
protected abstract void	setMappedProperty(java.lang.Object bean, java.lang.String name, java.lang.String key, java.lang.Object value) Set the value of the specified mapped property of the specified bean, with no type conversions.
protected void	setOrAddIndexValue(java.lang.String name, java.lang.Object bean, int index, java.lang.Object value) 设置List对象索引指定位置的值 index为-1时向列表头部添加元素, index为-2时向列表尾部添加元素,
java.lang.Object	setProperty(java.lang.Object bean, java.lang.String name, java.lang.Object value) Set the value of the (possibly nested) property of the specified name, for the specified bean, with no type conversions.
protected java.lang.Object	setProperty0(java.lang.Object bean, java.lang.String name, java.lang.Object value)
java.lang.Object	setPropertyChecked(java.lang.Object bean, java.lang.String name, java.lang.Object value) Set the value of the (possibly nested) property of the specified name, for the specified bean, with no type conversions.
protected abstract void	setSimpleProperty(java.lang.Object bean, java.lang.String name, java.lang.Object value) Set the value of the specified simple property of the specified bean, with no type conversions.
static void	setTraceEnabled(boolean traceEnabled)
protected abstract java.lang.Object	tryConstructIfNull(java.lang.Object nestedBean, java.lang.Object bean, java.lang.String name, java.lang.Class<?> expectType) 当nestedBean为null时尝试为bean的name字段构造新实例

从类继承的方法 java.lang.Object

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

字段详细资料

BEAN_SUPPORT

public static final BeanPropertySupport BEAN_SUPPORT

EMPTY_OBJECT_ARRAY

protected static final java.lang.Object[] EMPTY_OBJECT_ARRAY

An empty object array

traceEnabled

protected static boolean traceEnabled

构造器详细资料

BeanPropertySupport

protected BeanPropertySupport()

方法详细资料

getPropertyNames

public abstract java.util.Set<java.lang.String> getPropertyNames(java.lang.Class<?> beanClass,
                                                                 int rw,
                                                                 boolean lenient)

获取beanClass中所有具有指定读写类型(rw)的属性名集合

参数:

beanClass -

rw - 属性类型标记

0 所有属性

1 读属性

2 写属性

3 读写属性

lenient - 是否为宽容模式---允许返回类型不为void的setter方法

返回:

属性名与PropertyDescriptor映射的Map对象

从以下版本开始:

2.8.0

getPropertyNames

public java.util.Set<java.lang.String> getPropertyNames(java.lang.Object bean,
                                                        int rw,
                                                        boolean lenient)

从以下版本开始:

2.8.0

另请参阅:

getPropertyNames(Class, int, boolean)

clearDescriptors

public abstract void clearDescriptors()

Clear any cached property descriptors information for all classes loaded by any class loaders. This is useful in cases where class loaders are thrown away to implement class reloading.

getProperty

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

Return the value of the (possibly nested) property of the specified name, for the specified bean, with no type conversions.

参数:

bean - Bean whose property is to be extracted

name - Possibly nested name of the property to be extracted

返回:

the nested property value

另请参阅:

getProperty(Object, String, Object)

getProperty

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

Return the value of the (possibly nested) property of the specified name, for the specified bean, with no type conversions.

参数:

bean - Bean whose property is to be extracted

name - Possibly nested name of the property to be extracted

defaultValue - default value if value of property is null

返回:

the nested property value

抛出:

BeanPropertyRuntimeException - wrap all reflect option exception

getPropertyCheckType

public <T> T getPropertyCheckType(java.lang.Object bean,
                                  java.lang.String name,
                                  java.lang.Class<T> targetType)
                           throws BeanPropertyRuntimeException

Return the value of the (possibly nested) property of the specified name, for the specified bean, cast to target type.if value is String,try to parse json to target type.

参数:

bean - Bean whose property is to be extracted

name - Possibly nested name of the property to be extracted

targetType - type required

返回:

the nested property value

抛出:

BeanPropertyRuntimeException - wrap all reflect option exception

getPropertyChecked

public java.lang.Object getPropertyChecked(java.lang.Object bean,
                                           java.lang.String name)
                                    throws java.lang.IllegalAccessException,
                                           java.lang.reflect.InvocationTargetException,
                                           java.lang.NoSuchMethodException

Return the value of the (possibly nested) property of the specified name, for the specified bean, with no type conversions.

参数:

bean - Bean whose property is to be extracted

name - Possibly nested name of the property to be extracted

返回:

the nested property value

抛出:

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.IllegalArgumentException - if bean or name is null

NestedNullException - if a nested reference to a property returns null

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

getProperty0

protected java.lang.Object getProperty0(java.lang.Object bean,
                                        java.lang.String name)
                                 throws java.lang.IllegalArgumentException,
                                        java.lang.IllegalAccessException,
                                        java.lang.reflect.InvocationTargetException,
                                        java.lang.NoSuchMethodException

抛出:

java.lang.IllegalArgumentException

java.lang.IllegalAccessException

java.lang.reflect.InvocationTargetException

java.lang.NoSuchMethodException

getMappedProperty

protected java.lang.Object getMappedProperty(java.lang.Object bean,
                                             java.lang.String name)
                                      throws java.lang.IllegalAccessException,
                                             java.lang.reflect.InvocationTargetException,
                                             java.lang.NoSuchMethodException

Return the value of the specified mapped property of the specified bean, with no type conversions. The key of the required value must be included (in brackets) as a suffix to the property name, or IllegalArgumentException will be thrown.

参数:

bean - Bean whose property is to be extracted

name - propertyname(key) of the property value to be extracted

返回:

the mapped property value

抛出:

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

getMappedProperty

protected abstract java.lang.Object getMappedProperty(java.lang.Object bean,
                                                      java.lang.String name,
                                                      java.lang.String key)
                                               throws java.lang.IllegalAccessException,
                                                      java.lang.reflect.InvocationTargetException,
                                                      java.lang.NoSuchMethodException

Return the value of the specified mapped property of the specified bean, with no type conversions.

参数:

bean - Bean whose property is to be extracted

name - Mapped property name of the property value to be extracted

key - Key of the property value to be extracted

返回:

the mapped property value

抛出:

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

getIndexedProperty

protected java.lang.Object getIndexedProperty(java.lang.Object bean,
                                              java.lang.String name)
                                       throws java.lang.IllegalAccessException,
                                              java.lang.reflect.InvocationTargetException,
                                              java.lang.NoSuchMethodException

Return the value of the specified indexed property of the specified bean, with no type conversions. The zero-relative index of the required value must be included (in square brackets) as a suffix to the property name, or IllegalArgumentException will be thrown. In addition to supporting the JavaBeans specification, this method has been extended to support List objects as well.

参数:

bean - Bean whose property is to be extracted

name - propertyname[index] of the property value to be extracted

返回:

the indexed property value

抛出:

java.lang.IndexOutOfBoundsException - if the specified index is outside the valid range for the underlying array or List

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.IllegalArgumentException - if bean or name is null

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

getIndexedProperty

protected abstract java.lang.Object getIndexedProperty(java.lang.Object bean,
                                                       java.lang.String name,
                                                       int index)
                                                throws java.lang.IllegalAccessException,
                                                       java.lang.reflect.InvocationTargetException,
                                                       java.lang.NoSuchMethodException

Return the value of the specified indexed property of the specified bean, with no type conversions. In addition to supporting the JavaBeans specification, this method has been extended to support List objects as well.

参数:

bean - Bean whose property is to be extracted

name - Simple property name of the property value to be extracted

index - Index of the property value to be extracted

返回:

the indexed property value

抛出:

java.lang.IndexOutOfBoundsException - if the specified index is outside the valid range for the underlying property

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.IllegalArgumentException - if bean or name is null

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

getSearchedProperty

protected java.lang.Object getSearchedProperty(java.lang.Object bean,
                                               java.lang.String name)
                                        throws java.lang.IllegalAccessException,
                                               java.lang.reflect.InvocationTargetException,
                                               java.lang.NoSuchMethodException

Return the value of the specified indexed property of the specified bean, with no type conversions. The zero-relative index of the required value must be included (in square brackets) as a suffix to the property name, or IllegalArgumentException will be thrown. In addition to supporting the JavaBeans specification, this method has been extended to support List objects as well.

参数:

bean - Bean whose property is to be extracted

name - propertyname[index] of the property value to be extracted

返回:

the indexed property value

抛出:

java.lang.IndexOutOfBoundsException - if the specified index is outside the valid range for the underlying array or List

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.IllegalArgumentException - if bean or name is null

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

getSearchedProperty

protected abstract java.lang.Object getSearchedProperty(java.lang.Object bean,
                                                        java.lang.String name,
                                                        java.lang.String field,
                                                        java.lang.Object conditionValue)
                                                 throws java.lang.IllegalAccessException,
                                                        java.lang.reflect.InvocationTargetException,
                                                        java.lang.NoSuchMethodException

Return the value of the specified indexed property of the specified bean, with no type conversions. In addition to supporting the JavaBeans specification, this method has been extended to support List objects as well.

参数:

bean - Bean whose property is to be extracted

name - Simple property name of the property value to be extracted

field - sub property name

conditionValue - search satisfied value of field

返回:

the indexed property value

抛出:

java.lang.IndexOutOfBoundsException - if the specified index is outside the valid range for the underlying property

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.IllegalArgumentException - if bean or name is null

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this property cannot be found

getSimpleProperty

protected abstract java.lang.Object getSimpleProperty(java.lang.Object bean,
                                                      java.lang.String name)
                                               throws java.lang.IllegalAccessException,
                                                      java.lang.reflect.InvocationTargetException,
                                                      java.lang.NoSuchMethodException

Return the value of the specified simple property of the specified bean, with no type conversions.

参数:

bean - Bean whose property is to be extracted

name - Name of the property to be extracted

返回:

The property value

抛出:

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.IllegalArgumentException - if bean or name is null

java.lang.IllegalArgumentException - if the property name is nested or indexed

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

setProperty

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

Set the value of the (possibly nested) property of the specified name, for the specified bean, with no type conversions.

参数:

bean - Bean whose property is to be modified

name - Possibly nested name of the property to be modified

value - Value to which the property is to be set

返回:

抛出:

BeanPropertyRuntimeException - wrap all reflect option exception

另请参阅:

setPropertyChecked(Object, String, Object)

setPropertyChecked

public java.lang.Object setPropertyChecked(java.lang.Object bean,
                                           java.lang.String name,
                                           java.lang.Object value)
                                    throws java.lang.IllegalAccessException,
                                           java.lang.reflect.InvocationTargetException,
                                           java.lang.NoSuchMethodException

Set the value of the (possibly nested) property of the specified name, for the specified bean, with no type conversions.

Example values for parameter "name" are:

• "a" -- sets the value of property a of the specified bean
• "a.b" -- gets the value of property a of the specified bean, then on that object sets the value of property b.
• "a(key)" -- sets a value of mapped-property a on the specified bean. This effectively means bean.setA("key").
• "a[3]" -- sets a value of indexed-property a on the specified bean. This effectively means bean.setA(3).

参数:

bean - Bean whose property is to be modified

name - Possibly nested name of the property to be modified

value - Value to which the property is to be set

返回:

抛出:

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.IllegalArgumentException - if bean or name is null

java.lang.IllegalArgumentException - if a nested reference to a property returns null

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

setProperty0

protected java.lang.Object setProperty0(java.lang.Object bean,
                                        java.lang.String name,
                                        java.lang.Object value)
                                 throws java.lang.IllegalArgumentException,
                                        java.lang.IllegalAccessException,
                                        java.lang.reflect.InvocationTargetException,
                                        java.lang.NoSuchMethodException

抛出:

java.lang.IllegalArgumentException

java.lang.IllegalAccessException

java.lang.reflect.InvocationTargetException

java.lang.NoSuchMethodException

setMappedProperty

protected void setMappedProperty(java.lang.Object bean,
                                 java.lang.String name,
                                 java.lang.Object value)
                          throws java.lang.IllegalAccessException,
                                 java.lang.reflect.InvocationTargetException,
                                 java.lang.NoSuchMethodException

Set the value of the specified mapped property of the specified bean, with no type conversions. The key of the value to set must be included (in brackets) as a suffix to the property name, or IllegalArgumentException will be thrown.

参数:

bean - Bean whose property is to be set

name - propertyname(key) of the property value to be set

value - The property value to be set

抛出:

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

setMappedProperty

protected abstract void setMappedProperty(java.lang.Object bean,
                                          java.lang.String name,
                                          java.lang.String key,
                                          java.lang.Object value)
                                   throws java.lang.IllegalAccessException,
                                          java.lang.reflect.InvocationTargetException,
                                          java.lang.NoSuchMethodException

Set the value of the specified mapped property of the specified bean, with no type conversions.

参数:

bean - Bean whose property is to be set

name - Mapped property name of the property value to be set

key - Key of the property value to be set

value - The property value to be set

抛出:

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

setIndexedProperty

protected void setIndexedProperty(java.lang.Object bean,
                                  java.lang.String name,
                                  java.lang.Object value)
                           throws java.lang.IllegalAccessException,
                                  java.lang.reflect.InvocationTargetException,
                                  java.lang.NoSuchMethodException

Set the value of the specified indexed property of the specified bean, with no type conversions. The zero-relative index of the required value must be included (in square brackets) as a suffix to the property name, or IllegalArgumentException will be thrown. In addition to supporting the JavaBeans specification, this method has been extended to support List objects as well.

参数:

bean - Bean whose property is to be modified

name - propertyname[index] of the property value to be modified

value - Value to which the specified property element should be set

抛出:

java.lang.IndexOutOfBoundsException - if the specified index is outside the valid range for the underlying property

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.IllegalArgumentException - if bean or name is null

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

setIndexedProperty

protected abstract void setIndexedProperty(java.lang.Object bean,
                                           java.lang.String name,
                                           int index,
                                           java.lang.Object value)
                                    throws java.lang.IllegalAccessException,
                                           java.lang.reflect.InvocationTargetException,
                                           java.lang.NoSuchMethodException

Set the value of the specified indexed property of the specified bean, with no type conversions. In addition to supporting the JavaBeans specification, this method has been extended to support List objects as well.

参数:

bean - Bean whose property is to be set

name - Simple property name of the property value to be set

index - Index of the property value to be set

value - Value to which the indexed property element is to be set

抛出:

java.lang.IndexOutOfBoundsException - if the specified index is outside the valid range for the underlying property

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.IllegalArgumentException - if bean or name is null

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

setOrAddIndexValue

protected void setOrAddIndexValue(java.lang.String name,
                                  java.lang.Object bean,
                                  int index,
                                  java.lang.Object value)

设置List对象索引指定位置的值
index为-1时向列表头部添加元素, index为-2时向列表尾部添加元素,

参数:

name -

bean -

index -

value -

getIndexValue

protected java.lang.Object getIndexValue(java.lang.String name,
                                         java.lang.Object bean,
                                         int index)

返回List对象索引指定位置的值
index为-1时返回列表第一个元素，等同于0, index为-2时返回列表最后一个元素,

参数:

bean -

index -

bean -

setSimpleProperty

protected abstract void setSimpleProperty(java.lang.Object bean,
                                          java.lang.String name,
                                          java.lang.Object value)
                                   throws java.lang.IllegalAccessException,
                                          java.lang.reflect.InvocationTargetException,
                                          java.lang.NoSuchMethodException

Set the value of the specified simple property of the specified bean, with no type conversions.

参数:

bean - Bean whose property is to be modified

name - Name of the property to be modified

value - Value to which the property should be set

抛出:

java.lang.IllegalAccessException - if the caller does not have access to the property accessor method

java.lang.IllegalArgumentException - if bean or name is null

java.lang.IllegalArgumentException - if the property name is nested or indexed

java.lang.reflect.InvocationTargetException - if the property accessor method throws an exception

java.lang.NoSuchMethodException - if an accessor method for this propety cannot be found

copyProperties

public abstract void copyProperties(java.lang.Object dest,
                                    java.lang.Object orig)

Copy property values from the "origin" bean to the "destination" bean for all cases where the property names are the same (even though the actual getter and setter methods might have been customized via BeanInfo classes). No conversions are performed on the actual property values -- it is assumed that the values retrieved from the origin bean are assignment-compatible with the types expected by the destination bean.

If the origin "bean" is actually a Map, it is assumed to contain String-valued simple property names as the keys, pointing at the corresponding property values that will be set in the destination bean.Note that this method is intended to perform a "shallow copy" of the properties and so complex properties (for example, nested ones) will not be copied.

Note, that this method will not copy a List to a List, or an Object[] to an Object[]. It's specifically for copying JavaBean properties.

参数:

dest - Destination bean whose properties are modified

orig - Origin bean whose properties are retrieved orig argument is null

isReadable

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

Return true if the specified property name identifies a readable property on the specified bean; otherwise, return false.

参数:

bean - Bean to be examined

name - Property name to be evaluated

返回:

true if the property is readable, otherwise false

抛出:

java.lang.IllegalArgumentException - if bean or name is null

isWriteable

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

Return true if the specified property name identifies a writeable property on the specified bean; otherwise, return false.

参数:

bean - Bean to be examined

name - Property name to be evaluated

返回:

true if the property is writeable, otherwise false

抛出:

java.lang.IllegalArgumentException - if bean or name is null

createBeanDifference

public <T> BeanDifference createBeanDifference(com.google.common.base.Function<T,java.lang.Object> rightGetter)

describe

public java.util.Map<java.lang.String,java.lang.Object> describe(java.lang.Object bean)

以嵌套节点方式输出指定对象所有字段内容

参数:

bean - Bean whose properties are to be extracted

返回:

The set of properties for the bean

describe

public java.util.Map<java.lang.String,java.lang.Object> describe(java.lang.Object bean,
                                                                 boolean throwOnCycleReference)

以嵌套节点方式输出指定对象所有字段内容

参数:

bean - Bean whose properties are to be extracted

throwOnCycleReference - 当检测到循环引用时是否抛出CycleReferenceException

返回:

The set of properties for the bean

从以下版本开始:

2.7.7

hasCycleReference

public boolean hasCycleReference(java.lang.Object bean)

检查是否有循环引用,如果有循环引用返回true否则返回false

参数:

bean -

从以下版本开始:

2.7.7

checkCycleReference

public void checkCycleReference(java.lang.Object bean)
                         throws CycleReferenceException

检查是否有循环引用,有则抛出异常

参数:

bean -

抛出:

CycleReferenceException - 检测到循环引用

从以下版本开始:

2.7.7

different

public java.util.Map<java.lang.String,BeanPropertySupport.DiffNode> different(java.lang.Object left,
                                                                              java.lang.Object right)

返回两个对象之间差异的字段

参数:

left -

right -

different

public java.util.Map<java.lang.String,BeanPropertySupport.DiffNode> different(java.lang.Object left,
                                                                              java.lang.Object right,
                                                                              java.lang.String focusNames)

返回两个对象之间差异的字段

参数:

left -

right -

different

public java.util.Map<java.lang.String,BeanPropertySupport.DiffNode> different(java.lang.Object left,
                                                                              java.lang.Object right,
                                                                              java.lang.String... focusNames)

返回两个对象之间差异的字段

参数:

left -

right -

different

public java.util.Map<java.lang.String,BeanPropertySupport.DiffNode> different(java.lang.Object left,
                                                                              java.lang.Object right,
                                                                              java.lang.Iterable<java.lang.String> focusNames)

返回两个对象之间差异的字段

参数:

left -

right -

different

public java.util.Map<java.lang.String,BeanPropertySupport.DiffNode> different(java.lang.Object left,
                                                                              java.lang.Object right,
                                                                              com.google.common.base.Predicate<java.lang.String> originNameFilter,
                                                                              java.lang.Iterable<java.lang.String> focusNames)

返回两个对象之间差异的字段

参数:

left -

right -

originNameFilter -

focusNames -

返回:

different

public java.util.Map<java.lang.String,BeanPropertySupport.DiffNode> different(java.lang.Object left,
                                                                              java.lang.Object right,
                                                                              com.google.common.base.Predicate<java.lang.String> originNameFilter,
                                                                              java.lang.String... focusNames)

返回两个对象之间差异的字段

参数:

left -

right -

originNameFilter -

focusNames -

返回:

different

public java.util.Map<java.lang.String,BeanPropertySupport.DiffNode> different(java.lang.Object left,
                                                                              java.lang.Object right,
                                                                              com.google.common.base.Predicate<java.lang.String> originNameFilter,
                                                                              java.lang.String[] forceExcludeNames,
                                                                              boolean includeRequired,
                                                                              java.lang.String... focusNames)

返回两个对象之间差异的字段，返回不同的字段差异信息

另请参阅:

different(Object, Object, Predicate, Iterable, Iterable, boolean)

different

public java.util.Map<java.lang.String,BeanPropertySupport.DiffNode> different(java.lang.Object left,
                                                                              java.lang.Object right,
                                                                              com.google.common.base.Predicate<java.lang.String> originNameFilter,
                                                                              java.lang.Iterable<java.lang.String> forceExcludeNames,
                                                                              java.lang.Iterable<java.lang.String> focusNames,
                                                                              boolean includeRequired)

返回两个对象之间差异的字段，返回不同的字段差异信息

参数:

left -

right -

originNameFilter -

forceExcludeNames - 强制排除比较的字段名

focusNames - 比较字段黑/白名单

includeRequired - 为true时focusNames为白名单,否则为黑名单

searchIn

protected java.lang.Object searchIn(java.lang.Object input,
                                    java.lang.String field,
                                    java.lang.Object conditionValue)
                             throws java.lang.IllegalArgumentException,
                                    java.lang.IllegalAccessException,
                                    java.lang.reflect.InvocationTargetException,
                                    java.lang.NoSuchMethodException

在input中遍历所有元素找到匹配的值,没找到返回null

参数:

input -

field -

conditionValue -

抛出:

java.lang.IllegalArgumentException

java.lang.IllegalAccessException

java.lang.reflect.InvocationTargetException

java.lang.NoSuchMethodException

tryConstructIfNull

protected abstract java.lang.Object tryConstructIfNull(java.lang.Object nestedBean,
                                                       java.lang.Object bean,
                                                       java.lang.String name,
                                                       java.lang.Class<?> expectType)
                                                throws java.lang.IllegalAccessException,
                                                       java.lang.reflect.InvocationTargetException,
                                                       java.lang.NoSuchMethodException

当nestedBean为null时尝试为bean的name字段构造新实例

参数:

nestedBean -

bean -

name - 字段名

expectType - 期望的新实例类型，为null使用从字段对应的属性类型

返回:

抛出:

java.lang.IllegalAccessException

java.lang.reflect.InvocationTargetException

java.lang.NoSuchMethodException

setTraceEnabled

public static void setTraceEnabled(boolean traceEnabled)

isEmpty

public static boolean isEmpty(java.lang.Object value)

判断输入参数是否为null或空
如果输入参数为@String,Collection,Iterable,Iterator,Map,数组类型则返回其是否为空, 否则返回false

参数:

value - 为null返回true

isEmpty

public static boolean isEmpty(boolean all,
                              java.lang.Iterable<java.lang.Object> values)

判断输入参数是否都为空或有元素为空
如果all为true判断都为空,即values中的所有元素都为空时返回true 否则判断有空,即 values中的任一元素为空时就返回true, values为空则返回true

参数:

all - 为true要求values 所有元素为空，为false则只要values中元素为空即返回true

values - 待判空元素迭代器对象

从以下版本开始:

2.8.3

另请参阅:

isEmpty(Object)

isEmpty

public static boolean isEmpty(boolean all,
                              java.lang.Object... values)

判断输入参数是否都为空或有元素为空
如果all为true判断都为空,即values中的所有元素都为空时返回true 否则判断有空,即 values中的任一元素为空时就返回true, values为空则返回true

参数:

all - 为true要求values 所有元素为空，为false则只要values中元素为空即返回true

values - 待判空元素迭代器对象

从以下版本开始:

2.8.3

另请参阅:

isEmpty(Object)

allEmpty

public static boolean allEmpty(java.lang.Iterable<java.lang.Object> values)

判断输入参数是否都为空

参数:

values - 待判空元素迭代器对象

从以下版本开始:

2.8.3

另请参阅:

isEmpty(boolean, Iterable)

allEmpty

public static boolean allEmpty(java.lang.Object... values)

判断输入参数是否都为空

参数:

values - 待判空元素数组

从以下版本开始:

2.8.3

另请参阅:

isEmpty(boolean, Object...)

hasEmpty

public static boolean hasEmpty(java.lang.Iterable<java.lang.Object> values)

判断输入参数是否有为空的元素

参数:

values - 待判空元素迭代器对象

从以下版本开始:

2.8.3

另请参阅:

isEmpty(boolean, Iterable)

hasEmpty

public static boolean hasEmpty(java.lang.Object... values)

判断输入参数是否有为空的元素

参数:

values - 待判空元素数组

从以下版本开始:

2.8.3

另请参阅:

isEmpty(boolean, Object...)

maybeJsonString

protected static int maybeJsonString(java.lang.Object object)

判断对象是否有可能是JSON 字符串, 如果是String类型且前后以{}返回1 如果是String类型且前后以[]返回2 否则返回0

参数:

object -