Class BeanCopier
java.lang.Object
com.sure.tool.bean.BeanCopier
属性拷贝门面:在
BeanUtil 之上提供选项化与链式 API。
与 BeanUtil.copyProperties(Object, T, String...) 的差异:
- 目标属性只读默认抛
CopyException(选项CopyOption.IGNORE_READONLY跳过); - 支持
CopyOption.DEEP深拷贝(嵌套 Bean / 集合 / 数组递归); - 链式
of(Object)支持字段白名单/黑名单; - 类型转换失败抛带属性名的
CopyException(复用ConvertUtil)。
- Since:
- 1.18.0
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionstatic <T> T拷贝为新目标对象(默认浅拷贝)。static <T> Tcopy(Object source, Class<T> targetClass, CopyOption... options) 拷贝为新目标对象。static void拷贝到已有目标对象。static voidcopy(Object source, Object target, CopyOption... options) 拷贝到已有目标对象。static <T> T深拷贝为新目标对象(等价于copy(source, targetClass, CopyOption.DEEP))。static BeanCopier.Copier链式拷贝入口。static <T> TMap 转 Bean(带类型转换,支持枚举 String 转换)。Bean 转 Map(含 null 值)。
-
Method Details
-
copy
拷贝为新目标对象(默认浅拷贝)。- Type Parameters:
T- 目标类型- Parameters:
source- 源对象targetClass- 目标类型(需有无参构造器)- Returns:
- 新目标对象
- Throws:
CopyException- 目标实例化失败、属性只读或类型转换失败
-
copy
拷贝为新目标对象。- Type Parameters:
T- 目标类型- Parameters:
source- 源对象targetClass- 目标类型(需有无参构造器)options- 拷贝选项- Returns:
- 新目标对象
- Throws:
CopyException- 目标实例化失败、属性只读或类型转换失败
-
copy
拷贝到已有目标对象。- Parameters:
source- 源对象target- 目标对象- Throws:
CopyException- 属性只读或类型转换失败
-
copy
拷贝到已有目标对象。- Parameters:
source- 源对象target- 目标对象options- 拷贝选项- Throws:
CopyException- 属性只读或类型转换失败
-
deepCopy
-
toBean
Map 转 Bean(带类型转换,支持枚举 String 转换)。- Type Parameters:
T- Bean 类型- Parameters:
map- Map(key 为属性名)beanClass- Bean 类型- Returns:
- Bean 实例
- Throws:
CopyException- 目标实例化失败或属性转换失败
-
toMap
-
of
-