浙江中立建设网站,淄博微信网站建设,成都德阳网站建设,淘宝客个人网站建设一、需求背景
在日常Java开发中#xff0c;我么通常会使用 BeanUtils 的 copyProperties() 方法来实现对象属性复制。然而在实际业务场景中#xff0c;我们经常会遇到这样的需求#xff1a;
当源对象属性值为NULL时#xff0c;不希望覆盖目标对象原有的非NULL值。例如我么通常会使用 BeanUtils 的 copyProperties() 方法来实现对象属性复制。然而在实际业务场景中我们经常会遇到这样的需求
当源对象属性值为NULL时不希望覆盖目标对象原有的非NULL值。例如
// 用户更新信息场景
UserDTO userDTO new UserDTO();
userDTO.setName(张三);
userDTO.setAge(null); // 年龄字段为nullUser targetUser userService.getUserById(1);
// 原始targetUser.age25
BeanUtils.copyProperties(userDTO, targetUser);
// 此时targetUser.age会被覆盖为null不符合预期二、CopyOptions核心配置解析
2.1 CopyOptions概述
在Hutool工具包的BeanUtil中copyProperties()方法提供了更灵活的CopyOptions参数来控制拷贝行为
public static void copyProperties(Object source, Object target, CopyOptions copyOptions)
CopyOptions采用建造者模式设计主要包含以下配置项
配置项类型默认值说明ignoreNullValuebooleanfalse是否忽略NULL值ignoreCasebooleanfalse是否忽略字段名称大小写ignoreErrorbooleanfalse是否忽略拷贝错误editableClass?null限制目标对象类型ignorePropertiesString[]null要忽略的属性名数组overridebooleantrue是否覆盖已有值fieldMappingMapString, Stringnull字段名称映射关系
2.2 忽略NULL值的配置方法
要实现忽略NULL值的拷贝需要创建CopyOptions并设置 ignoreNullValue 为true
import cn.hutool.core.bean.BeanUtil;
import cn.hutool.core.bean.CopyOptions;// 创建配置
CopyOptions copyOptions CopyOptions.create().setIgnoreNullValue(true); // 关键配置// 执行拷贝
BeanUtil.copyProperties(source, target, copyOptions);三、深度配置示例
3.1 复合配置示例
// 复杂场景配置示例
CopyOptions options CopyOptions.create().setIgnoreNullValue(true) // 忽略null值.setIgnoreCase(true) // 忽略字段大小写.setIgnoreProperties(password) // 忽略密码字段.setOverride(false) // 不覆盖已有值.setFieldMapping(Collections.singletonMap(userName, name)); // 字段映射BeanUtil.copyProperties(dto, entity, options);3.2 与Spring框架的对比
Spring的BeanUtils.copyProperties()默认不支持忽略NULL值需要自行扩展
// Spring场景下的NULL值忽略实现
public class CustomBeanUtils extends BeanUtils {public static void copyPropertiesIgnoreNull(Object src, Object target) {PropertyDescriptor[] srcPds getPropertyDescriptors(src.getClass());for (PropertyDescriptor srcPd : srcPds) {if (srcPd.getReadMethod() ! null) {try {Object value srcPd.getReadMethod().invoke(src);if (value ! null) { // 只拷贝非NULL值PropertyDescriptor targetPd getPropertyDescriptor(target.getClass(), srcPd.getName());if (targetPd ! null targetPd.getWriteMethod() ! null) {targetPd.getWriteMethod().invoke(target, value);}}} catch (Exception ex) {throw new RuntimeException(ex);}}}}
}四、特殊场景处理
4.1 嵌套对象拷贝
对于嵌套对象的NULL值处理需要递归配置
public static void deepCopyIgnoreNull(Object source, Object target) {CopyOptions options CopyOptions.create().setIgnoreNullValue(true);BeanUtil.copyProperties(source, target, options);// 获取所有嵌套对象字段Field[] fields source.getClass().getDeclaredFields();for (Field field : fields) {if (field.getType().getName().startsWith(com.yourpackage)) {try {field.setAccessible(true);Object srcChild field.get(source);Object targetChild field.get(target);if (srcChild ! null targetChild ! null) {deepCopyIgnoreNull(srcChild, targetChild);}} catch (IllegalAccessException e) {// 异常处理}}}
}4.2 集合属性拷贝
// 集合属性拷贝示例
CopyOptions options CopyOptions.create().setIgnoreNullValue(true);ListSourceDTO sourceList ...;
ListTargetVO targetList new ArrayList();for (SourceDTO source : sourceList) {TargetVO target new TargetVO();BeanUtil.copyProperties(source, target, options);targetList.add(target);
}通过合理配置CopyOptions可以极大提升对象属性拷贝的灵活性和安全性满足各种业务场景的需求。
