javacommon.easytools.core.bean

类 BeanUtil

java.lang.Object

javacommon.easytools.core.bean.BeanUtil

public class BeanUtil
extends Object

Bean工具类

把一个拥有对属性进行set和get方法的类，我们就可以称之为JavaBean。

从以下版本开始:

3.1.2

构造器概要

构造器

构造器和说明
BeanUtil()

方法概要

限定符和类型	方法和说明
static Map<String,Object>	beanToMap(Object bean) 对象转Map，不进行驼峰转下划线，不忽略值为空的字段
static Map<String,Object>	beanToMap(Object bean, Map<String,Object> targetMap, boolean isToUnderlineCase, boolean ignoreNullValue) 对象转Map
static <T> Map<String,Object>	beanToMap(T bean, boolean isToUnderlineCase, boolean ignoreNullValue) 对象转Map
static void	copyProperties(Object source, Object target) 复制Bean对象属性
static void	copyProperties(Object source, Object target, boolean ignoreCase, CopyOptions copyOptions) 复制Bean对象属性 限制类用于限制拷贝的属性，例如一个类我只想复制其父类的一些属性，就可以将CopyOptions.editable设置为父类
static void	copyProperties(Object source, Object target, CopyOptions copyOptions) 复制Bean对象属性 限制类用于限制拷贝的属性，例如一个类我只想复制其父类的一些属性，就可以将editable设置为父类
static void	copyProperties(Object source, Object target, String... ignoreProperties) 复制Bean对象属性 限制类用于限制拷贝的属性，例如一个类我只想复制其父类的一些属性，就可以将editable设置为父类
static DynaBean	createDynaBean(Object bean) 创建动态Bean
static <T> T	fillBean(T bean, ValueProvider<String> valueProvider, CopyOptions copyOptions) 填充Bean的核心方法
static <T> T	fillBeanWithMap(Map<?,?> map, T bean, boolean isIgnoreError) 使用Map填充Bean对象
static <T> T	fillBeanWithMap(Map<?,?> map, T bean, boolean isToCamelCase, boolean isIgnoreError) 使用Map填充Bean对象，可配置将下划线转换为驼峰
static <T> T	fillBeanWithMap(Map<?,?> map, T bean, boolean isToCamelCase, CopyOptions copyOptions) 使用Map填充Bean对象
static <T> T	fillBeanWithMap(Map<?,?> map, T bean, CopyOptions copyOptions) 使用Map填充Bean对象
static <T> T	fillBeanWithMapIgnoreCase(Map<?,?> map, T bean, boolean isIgnoreError) 使用Map填充Bean对象，忽略大小写
static PropertyEditor	findEditor(Class<?> type) 查找类型转换器 PropertyEditor
static BeanDesc	getBeanDesc(Class<?> clazz) 获取BeanDesc Bean描述信息
static Object	getFieldValue(Object bean, String fieldName) 获得字段值，通过反射直接获得字段值，并不调用getXXX方法 对象同样支持Map类型，fieldName即为key
static Object	getProperty(Object bean, String expression) 解析Bean中的属性值
static PropertyDescriptor	getPropertyDescriptor(Class<?> clazz, String fieldName) 获得Bean类属性描述，大小写敏感
static PropertyDescriptor	getPropertyDescriptor(Class<?> clazz, String fieldName, boolean ignoreCase) 获得Bean类属性描述
static Map<String,PropertyDescriptor>	getPropertyDescriptorMap(Class<?> clazz, boolean ignoreCase) 获得字段名和字段描述Map，获得的结果会缓存在 BeanInfoCache中
static PropertyDescriptor[]	getPropertyDescriptors(Class<?> clazz) 获得Bean字段描述数组
static boolean	hasNull(Object bean, boolean ignoreError)
static boolean	isBean(Class<?> clazz) 判断是否为Bean对象 判定方法是是否存在只有一个参数的setXXX方法
static <T> T	mapToBean(Map<?,?> map, Class<T> beanClass, boolean isIgnoreError) Map转换为Bean对象
static <T> T	mapToBean(Map<?,?> map, Class<T> beanClass, CopyOptions copyOptions) Map转换为Bean对象
static <T> T	mapToBeanIgnoreCase(Map<?,?> map, Class<T> beanClass, boolean isIgnoreError) Map转换为Bean对象 忽略大小写
static <T> T	toBean(Class<T> beanClass, ValueProvider<String> valueProvider, CopyOptions copyOptions) ServletRequest 参数转Bean

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

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

构造器详细资料

BeanUtil

public BeanUtil()

方法详细资料

isBean

public static boolean isBean(Class<?> clazz)

判断是否为Bean对象
判定方法是是否存在只有一个参数的setXXX方法

参数:

clazz - 待测试类

返回:

是否为Bean对象

createDynaBean

public static DynaBean createDynaBean(Object bean)

创建动态Bean

参数:

bean - 普通Bean或Map

返回:

DynaBean

从以下版本开始:

3.0.7

findEditor

public static PropertyEditor findEditor(Class<?> type)

查找类型转换器 PropertyEditor

参数:

type - 需要转换的目标类型

返回:

PropertyEditor

hasNull

public static boolean hasNull(Object bean,
                              boolean ignoreError)

getBeanDesc

public static BeanDesc getBeanDesc(Class<?> clazz)

获取BeanDesc Bean描述信息

参数:

clazz - Bean类

返回:

BeanDesc

从以下版本开始:

3.1.2

getPropertyDescriptors

public static PropertyDescriptor[] getPropertyDescriptors(Class<?> clazz)
                                                   throws IntrospectionException

获得Bean字段描述数组

参数:

clazz - Bean类

返回:

字段描述数组

抛出:

IntrospectionException - 获取属性异常

getPropertyDescriptorMap

public static Map<String,PropertyDescriptor> getPropertyDescriptorMap(Class<?> clazz,
                                                                      boolean ignoreCase)
                                                               throws IntrospectionException

获得字段名和字段描述Map，获得的结果会缓存在 BeanInfoCache中

参数:

clazz - Bean类

ignoreCase - 是否忽略大小写

返回:

字段名和字段描述Map

抛出:

IntrospectionException - 获取属性异常

getPropertyDescriptor

public static PropertyDescriptor getPropertyDescriptor(Class<?> clazz,
                                                       String fieldName)
                                                throws IntrospectionException

获得Bean类属性描述，大小写敏感

参数:

clazz - Bean类

fieldName - 字段名

返回:

PropertyDescriptor

抛出:

IntrospectionException - 获取属性异常

getPropertyDescriptor

public static PropertyDescriptor getPropertyDescriptor(Class<?> clazz,
                                                       String fieldName,
                                                       boolean ignoreCase)
                                                throws IntrospectionException

获得Bean类属性描述

参数:

clazz - Bean类

fieldName - 字段名

ignoreCase - 是否忽略大小写

返回:

PropertyDescriptor

抛出:

IntrospectionException - 获取属性异常

getFieldValue

public static Object getFieldValue(Object bean,
                                   String fieldName)

获得字段值，通过反射直接获得字段值，并不调用getXXX方法
对象同样支持Map类型，fieldName即为key

参数:

bean - Bean对象

fieldName - 字段名

返回:

字段值

getProperty

public static Object getProperty(Object bean,
                                 String expression)

解析Bean中的属性值

参数:

bean - Bean对象，支持Map、List、Collection、Array

expression - 表达式，例如：person.friend[5].name

返回:

Bean属性值

从以下版本开始:

3.0.7

另请参阅:

BeanResolver.resolveBean(Object, String)

mapToBean

public static <T> T mapToBean(Map<?,?> map,
                              Class<T> beanClass,
                              boolean isIgnoreError)

Map转换为Bean对象

类型参数:

T - Bean类型

参数:

map - Map

beanClass - Bean Class

isIgnoreError - 是否忽略注入错误

返回:

Bean

mapToBeanIgnoreCase

public static <T> T mapToBeanIgnoreCase(Map<?,?> map,
                                        Class<T> beanClass,
                                        boolean isIgnoreError)

Map转换为Bean对象
忽略大小写

类型参数:

T - Bean类型

参数:

map - Map

beanClass - Bean Class

isIgnoreError - 是否忽略注入错误

返回:

Bean

mapToBean

public static <T> T mapToBean(Map<?,?> map,
                              Class<T> beanClass,
                              CopyOptions copyOptions)

Map转换为Bean对象

类型参数:

T - Bean类型

参数:

map - Map

beanClass - Bean Class

copyOptions - 转Bean选项

返回:

Bean

fillBeanWithMap

public static <T> T fillBeanWithMap(Map<?,?> map,
                                    T bean,
                                    boolean isIgnoreError)

使用Map填充Bean对象

类型参数:

T - Bean类型

参数:

map - Map

bean - Bean

isIgnoreError - 是否忽略注入错误

返回:

Bean

fillBeanWithMap

public static <T> T fillBeanWithMap(Map<?,?> map,
                                    T bean,
                                    boolean isToCamelCase,
                                    boolean isIgnoreError)

使用Map填充Bean对象，可配置将下划线转换为驼峰

类型参数:

T - Bean类型

参数:

map - Map

bean - Bean

isToCamelCase - 是否将下划线模式转换为驼峰模式

isIgnoreError - 是否忽略注入错误

返回:

Bean

fillBeanWithMapIgnoreCase

public static <T> T fillBeanWithMapIgnoreCase(Map<?,?> map,
                                              T bean,
                                              boolean isIgnoreError)

使用Map填充Bean对象，忽略大小写

类型参数:

T - Bean类型

参数:

map - Map

bean - Bean

isIgnoreError - 是否忽略注入错误

返回:

Bean

fillBeanWithMap

public static <T> T fillBeanWithMap(Map<?,?> map,
                                    T bean,
                                    CopyOptions copyOptions)

使用Map填充Bean对象

类型参数:

T - Bean类型

参数:

map - Map

bean - Bean

copyOptions - 属性复制选项 CopyOptions

返回:

Bean

fillBeanWithMap

public static <T> T fillBeanWithMap(Map<?,?> map,
                                    T bean,
                                    boolean isToCamelCase,
                                    CopyOptions copyOptions)

使用Map填充Bean对象

类型参数:

T - Bean类型

参数:

map - Map

bean - Bean

isToCamelCase - 是否将Map中的下划线风格key转换为驼峰风格

copyOptions - 属性复制选项 CopyOptions

返回:

Bean

从以下版本开始:

3.3.1

toBean

public static <T> T toBean(Class<T> beanClass,
                           ValueProvider<String> valueProvider,
                           CopyOptions copyOptions)

ServletRequest 参数转Bean

类型参数:

T - Bean类型

参数:

beanClass - Bean Class

valueProvider - 值提供者

copyOptions - 拷贝选项，见 CopyOptions

返回:

Bean

fillBean

public static <T> T fillBean(T bean,
                             ValueProvider<String> valueProvider,
                             CopyOptions copyOptions)

填充Bean的核心方法

类型参数:

T - Bean类型

参数:

bean - Bean

valueProvider - 值提供者

copyOptions - 拷贝选项，见 CopyOptions

返回:

Bean

beanToMap

public static Map<String,Object> beanToMap(Object bean)

对象转Map，不进行驼峰转下划线，不忽略值为空的字段

参数:

bean - bean对象

返回:

Map

beanToMap

public static <T> Map<String,Object> beanToMap(T bean,
                                               boolean isToUnderlineCase,
                                               boolean ignoreNullValue)

对象转Map

类型参数:

T -

参数:

bean - bean对象

isToUnderlineCase - 是否转换为下划线模式

ignoreNullValue - 是否忽略值为空的字段

返回:

Map

beanToMap

public static Map<String,Object> beanToMap(Object bean,
                                           Map<String,Object> targetMap,
                                           boolean isToUnderlineCase,
                                           boolean ignoreNullValue)

对象转Map

参数:

bean - bean对象

targetMap - 目标的Map

isToUnderlineCase - 是否转换为下划线模式

ignoreNullValue - 是否忽略值为空的字段

返回:

Map

从以下版本开始:

3.2.3

copyProperties

public static void copyProperties(Object source,
                                  Object target)

复制Bean对象属性

参数:

source - 源Bean对象

target - 目标Bean对象

copyProperties

public static void copyProperties(Object source,
                                  Object target,
                                  String... ignoreProperties)

复制Bean对象属性
限制类用于限制拷贝的属性，例如一个类我只想复制其父类的一些属性，就可以将editable设置为父类

参数:

source - 源Bean对象

target - 目标Bean对象

ignoreProperties - 不拷贝的的属性列表

copyProperties

public static void copyProperties(Object source,
                                  Object target,
                                  CopyOptions copyOptions)

复制Bean对象属性
限制类用于限制拷贝的属性，例如一个类我只想复制其父类的一些属性，就可以将editable设置为父类

参数:

source - 源Bean对象

target - 目标Bean对象

copyOptions - 拷贝选项，见 CopyOptions

copyProperties

public static void copyProperties(Object source,
                                  Object target,
                                  boolean ignoreCase,
                                  CopyOptions copyOptions)

复制Bean对象属性
限制类用于限制拷贝的属性，例如一个类我只想复制其父类的一些属性，就可以将CopyOptions.editable设置为父类

参数:

source - 源Bean对象

target - 目标Bean对象

ignoreCase - 是否忽略大小写

copyOptions - 拷贝选项，见 CopyOptions