Class BeanUtil
java.lang.Object
com.sure.tool.bean.BeanUtil
Bean 属性操作工具类:属性拷贝、Bean/Map 互转、属性读写,参考 Hutool 的
BeanUtil 设计。
English: JavaBean property reading, writing and map-to-bean conversion.
- Since:
- 0.1.0
- Author:
- suretool
-
Method Summary
Modifier and TypeMethodDescriptionBean 转 Map(不忽略 null 值)。Bean 转 Map。static <T> TcopyProperties(Object source, T target, boolean ignoreNullValue, String... ignoreProperties) 拷贝属性,支持类型转换(如 String 转 int)。static <T> TcopyProperties(Object source, T target, String... ignoreProperties) 拷贝属性(不忽略 null 值)。static <T> List<T> copyToList(Collection<?> collection, Class<T> targetClass) 将对象集合复制为指定 Bean 类型的列表(深复制,忽略源 null 值)。static <T> List<T> copyToList(Collection<?> collection, Class<T> targetClass, boolean ignoreNullValue) 将对象集合复制为指定 Bean 类型的列表。static <T> TdeepCopy(T source) 深拷贝:递归复制 Bean / Map / List / Set / 数组 / 不可变值类型。static <T> T用 Map 填充 Bean 属性(值为null的键跳过,不覆盖已有值)。static BeanDescgetBeanDesc(Class<?> clazz) 获取 Bean 描述(带缓存)。static ObjectgetProperty(Object bean, String name) 读取属性值。static boolean判断是否为可操作 Bean(非基础类型、非容器、非日期等)。static <T> TMap 转 Bean(自动实例化并写入属性,带类型转换)。static <T> TMap 转 Bean,可指定是否忽略转换异常(出错属性跳过)。static voidsetProperty(Object bean, String name, Object value) 写入属性值(带类型转换)。static <T> T对象转 Bean:Map 走mapToBean(Map, Class),普通 Bean 走copyProperties(Object, T, String...),其他类型返回原对象。static <T> T对象转 Bean,可指定是否忽略源 null 值。
-
Method Details
-
getBeanDesc
-
copyProperties
-
copyProperties
-
beanToMap
-
beanToMap
-
mapToBean
-
getProperty
-
setProperty
-
toBean
对象转 Bean:Map 走mapToBean(Map, Class),普通 Bean 走copyProperties(Object, T, String...),其他类型返回原对象。- Type Parameters:
T- Bean 类型- Parameters:
source- 源对象(Map 或 Bean)beanClass- 目标 Bean 类- Returns:
- 转换后的 Bean;源为
null返回null
-
isBean
判断是否为可操作 Bean(非基础类型、非容器、非日期等)。- Parameters:
clazz- 类- Returns:
- 是否 Bean
-
deepCopy
public static <T> T deepCopy(T source) 深拷贝:递归复制 Bean / Map / List / Set / 数组 / 不可变值类型。规则:基本类型、包装类型、String、枚举、Date 直接返回原引用(不可变或无需拷贝); 集合与 Map 逐元素深拷贝;数组逐元素深拷贝;其余按 Bean 处理(无参构造 + 属性拷贝)。
注意:循环引用不处理(会栈溢出),请勿对存在环的对象图调用。
- Type Parameters:
T- 类型- Parameters:
source- 源对象- Returns:
- 深拷贝结果,入参为 null 时返回 null
-
fill
-
copyToList
将对象集合复制为指定 Bean 类型的列表(深复制,忽略源 null 值)。- Type Parameters:
T- 目标 Bean 类型- Parameters:
collection- 源对象集合(元素可为 Bean 或 Map)targetClass- 目标 Bean 类- Returns:
- 新列表;输入为 null 返回 null,元素转换失败返回 null 元素
-
copyToList
public static <T> List<T> copyToList(Collection<?> collection, Class<T> targetClass, boolean ignoreNullValue) 将对象集合复制为指定 Bean 类型的列表。- Type Parameters:
T- 目标 Bean 类型- Parameters:
collection- 源对象集合(元素可为 Bean 或 Map)targetClass- 目标 Bean 类ignoreNullValue- 是否忽略源 null 值属性- Returns:
- 新列表;输入为 null 返回 null,元素转换失败返回 null 元素
-
toBean
-
mapToBean
-