net.gdface.bean.jdk

类 BeanPropertySupportImpl

java.lang.Object

net.gdface.bean.BeanPropertySupport

net.gdface.bean.jdk.BeanPropertySupportImpl

@ActiveOnClass(value=java.beans.PropertyDescriptor.class)
public class BeanPropertySupportImpl
extends BeanPropertySupport

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

从以下版本开始:

2.7.0

作者:

guyadong

嵌套类概要

从类继承的嵌套类/接口 net.gdface.bean.BeanPropertySupport

BeanPropertySupport.DiffNode, BeanPropertySupport.ReadVisitor, BeanPropertySupport.WriteVisitor

字段概要

字段

限定符和类型	字段和说明
static BeanPropertySupportImpl	BEAN_SUPPORT

从类继承的字段 net.gdface.bean.BeanPropertySupport

EMPTY_OBJECT_ARRAY, traceEnabled

构造器概要

构造器

构造器和说明
BeanPropertySupportImpl()

方法概要

限定符和类型	方法和说明
void	addPropertyDescriptorFactory(PropertyDescriptorFactory element)
void	addPropertyDescriptorFactoryAsFirst(PropertyDescriptorFactory element)
void	clearDescriptors() Clear any cached property descriptors information for all classes loaded by any class loaders.
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).
protected 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	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.util.Map<java.lang.String,java.beans.PropertyDescriptor>	getMappedPropertyDescriptors(java.lang.Class<?> beanClass) Return the mapped property descriptors for this bean class.
java.util.Map<java.lang.String,java.beans.PropertyDescriptor>	getMappedPropertyDescriptors(java.lang.Object bean) Return the mapped property descriptors for this bean.
java.util.Map<java.lang.String,java.beans.PropertyDescriptor>	getProperties(java.lang.Class<?> beanClass, int rw, boolean lenient) 获取beanClass中所有具有指定读写类型(rw)的属性
java.beans.PropertyDescriptor	getPropertyDescriptor(java.lang.Object bean, java.lang.String name) Retrieve the property descriptor for the specified property of the specified bean, or return null if there is no such descriptor.
java.beans.PropertyDescriptor[]	getPropertyDescriptors(java.lang.Class<?> beanClass)
java.beans.PropertyDescriptor[]	getPropertyDescriptors(java.lang.Object bean) Retrieve the property descriptors for the specified bean, introspecting and caching them the first time a particular bean class is encountered.
java.util.Set<java.lang.String>	getPropertyNames(java.lang.Class<?> beanClass, int rw, boolean lenient) 获取beanClass中所有具有指定读写类型(rw)的属性名集合
protected 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 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
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.
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 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	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	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.
protected java.lang.Object	tryConstructIfNull(java.lang.Object nestedBean, java.lang.Object bean, java.lang.String name, java.lang.Class<?> expectType) 当nestedBean为null时尝试为bean的name字段构造新实例

从类继承的方法 net.gdface.bean.BeanPropertySupport

allEmpty, allEmpty, checkCycleReference, createBeanDifference, describe, describe, different, different, different, different, different, different, different, different, getIndexedProperty, getIndexValue, getMappedProperty, getProperty, getProperty, getProperty0, getPropertyChecked, getPropertyCheckType, getPropertyNames, getSearchedProperty, hasEmpty, hasEmpty, isEmpty, isEmpty, isEmpty, maybeJsonString, searchIn, setIndexedProperty, setMappedProperty, setOrAddIndexValue, setProperty, setProperty0, setPropertyChecked, setTraceEnabled

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

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

字段详细资料

BEAN_SUPPORT

public static final BeanPropertySupportImpl BEAN_SUPPORT

构造器详细资料

BeanPropertySupportImpl

public BeanPropertySupportImpl()

方法详细资料

getPropertyDescriptors

public java.beans.PropertyDescriptor[] getPropertyDescriptors(java.lang.Class<?> beanClass)

getProperties

public java.util.Map<java.lang.String,java.beans.PropertyDescriptor> getProperties(java.lang.Class<?> beanClass,
                                                                                   int rw,
                                                                                   boolean lenient)

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

参数:

beanClass -

rw - 属性类型标记

0 所有属性

1 读属性

2 写属性

3 读写属性

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

返回:

属性名与PropertyDescriptor映射的Map对象

getMappedPropertyDescriptors

public java.util.Map<java.lang.String,java.beans.PropertyDescriptor> getMappedPropertyDescriptors(java.lang.Class<?> beanClass)

Return the mapped property descriptors for this bean class.

参数:

beanClass -

另请参阅:

getProperties(Class, int, boolean)

getMappedPropertyDescriptors

public java.util.Map<java.lang.String,java.beans.PropertyDescriptor> getMappedPropertyDescriptors(java.lang.Object bean)

Return the mapped property descriptors for this bean.

参数:

bean - Bean to be introspected

返回:

the mapped property descriptors

getPropertyNames

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

从类复制的说明: BeanPropertySupport

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

指定者:

getPropertyNames 在类中 BeanPropertySupport

rw - 属性类型标记

0 所有属性

1 读属性

2 写属性

3 读写属性

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

返回:

属性名与PropertyDescriptor映射的Map对象

clearDescriptors

public void clearDescriptors()

从类复制的说明: BeanPropertySupport

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.

指定者:

clearDescriptors 在类中 BeanPropertySupport

getPropertyDescriptors

public java.beans.PropertyDescriptor[] getPropertyDescriptors(java.lang.Object bean)

Retrieve the property descriptors for the specified bean, introspecting and caching them the first time a particular bean class is encountered.

参数:

bean - Bean for which property descriptors are requested

返回:

the property descriptors

抛出:

java.lang.IllegalArgumentException - if bean is null

getPropertyDescriptor

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

Retrieve the property descriptor for the specified property of the specified bean, or return null if there is no such descriptor. This method resolves indexed and nested property references in the same manner as other methods in this class, except that if the last (or only) name element is indexed, the descriptor for the last resolved property itself is returned.

参数:

bean - Bean for which a property descriptor is requested

name - Possibly indexed and/or nested name of the property for which a property descriptor is requested

返回:

the property descriptor

抛出:

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

getSimpleProperty

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

从类复制的说明: BeanPropertySupport

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

指定者:

getSimpleProperty 在类中 BeanPropertySupport

参数:

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.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 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

从类复制的说明: BeanPropertySupport

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

指定者:

getMappedProperty 在类中 BeanPropertySupport

参数:

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

setMappedProperty

protected 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

从类复制的说明: BeanPropertySupport

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

指定者:

setMappedProperty 在类中 BeanPropertySupport

参数:

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

getIndexedProperty

protected 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

从类复制的说明: BeanPropertySupport

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.

指定者:

getIndexedProperty 在类中 BeanPropertySupport

参数:

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.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,
                                  int index,
                                  java.lang.Object value)
                           throws java.lang.IllegalAccessException,
                                  java.lang.reflect.InvocationTargetException,
                                  java.lang.NoSuchMethodException

从类复制的说明: BeanPropertySupport

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.

指定者:

setIndexedProperty 在类中 BeanPropertySupport

参数:

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.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

getSearchedProperty

protected 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

从类复制的说明: BeanPropertySupport

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.

指定者:

getSearchedProperty 在类中 BeanPropertySupport

参数:

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.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 property cannot be found

setSimpleProperty

protected 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

从类复制的说明: BeanPropertySupport

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

指定者:

setSimpleProperty 在类中 BeanPropertySupport

参数:

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.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 void copyProperties(java.lang.Object dest,
                           java.lang.Object orig)

从类复制的说明: BeanPropertySupport

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.

指定者:

copyProperties 在类中 BeanPropertySupport

参数:

dest - Destination bean whose properties are modified

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

isReadable

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

从类复制的说明: BeanPropertySupport

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

指定者:

isReadable 在类中 BeanPropertySupport

参数:

bean - Bean to be examined

name - Property name to be evaluated

返回:

true if the property is readable, otherwise false

isWriteable

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

从类复制的说明: BeanPropertySupport

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

指定者:

isWriteable 在类中 BeanPropertySupport

参数:

bean - Bean to be examined

name - Property name to be evaluated

返回:

true if the property is writeable, otherwise false

hasCycleReference

public boolean hasCycleReference(java.lang.Object bean)

从类复制的说明: BeanPropertySupport

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

覆盖:

hasCycleReference 在类中 BeanPropertySupport

tryConstructIfNull

protected 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

从类复制的说明: BeanPropertySupport

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

指定者:

tryConstructIfNull 在类中 BeanPropertySupport

name - 字段名

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

返回:

抛出:

java.lang.IllegalAccessException

java.lang.reflect.InvocationTargetException

java.lang.NoSuchMethodException

addPropertyDescriptorFactoryAsFirst

public void addPropertyDescriptorFactoryAsFirst(PropertyDescriptorFactory element)

addPropertyDescriptorFactory

public void addPropertyDescriptorFactory(PropertyDescriptorFactory element)