Spring中的BeanUtils.copyProperties

最新推荐文章于 2025-10-28 21:37:39 发布

转载最新推荐文章于 2025-10-28 21:37:39 发布 · 1.1k 阅读

1 ·

CC 4.0 BY-SA版权

原文链接：https://juejin.cn/post/7356772920277155890

文章标签：

#spring #python #前端

BeanUtils.copyProperties() 是 Spring 框架中的一个工具方法，用于将一个 JavaBean 对象的属性值复制到另一个 JavaBean 对象中。其作用是将源对象的属性值复制到目标对象中，从而实现对象属性的拷贝。下面详细解释其作用和原理：

作用：

属性拷贝：将一个对象的属性值复制到另一个对象中，通常用于 DTO（数据传输对象）和领域模型对象之间的属性拷贝，以便在它们之间进行数据传输和转换。
简化代码：避免了手动逐个设置属性值的繁琐过程，提高了代码的简洁性和可读性。
类型转换：在属性值拷贝过程中，BeanUtils 可以自动进行类型转换，使得源对象和目标对象的属性类型不必完全一致。

原理：

反射：BeanUtils.copyProperties() 方法通过 Java 的反射机制来实现属性值的复制。它会获取源对象和目标对象的所有属性，并逐一进行复制。
属性名匹配：方法会通过反射机制获取源对象和目标对象的所有属性，并且会根据属性名进行匹配。只有在源对象和目标对象中具有相同名称且可访问的属性时，才会进行属性复制。
属性赋值：对于匹配的属性，会将源对象中的属性值直接赋值给目标对象的对应属性。这里的赋值操作是直接的引用赋值，不会进行类型转换或者复制属性值所引用的对象。
类型兼容性：如果源对象的属性类型与目标对象的属性类型不兼容，例如源对象的属性是基本类型，而目标对象的属性是包装类型，或者两者的属性类型不同，那么在赋值过程中会抛出类型转换异常。
属性过滤：可以通过设置参数来指定要复制的属性列表，从而实现部分属性的复制。

因此，在使用 BeanUtils.copyProperties() 方法时，需要注意确保源对象和目标对象的属性类型和名称都匹配，以避免类型转换异常或属性复制不完整的情况发生。对于类型不匹配的属性，需要提前进行类型转换或者采取其他适当的处理方式。

是浅拷贝还是深拷贝？

BeanUtils.copyProperties() 方法实现的是浅拷贝。

在浅拷贝中，只复制对象的引用，而不复制引用指向的对象。这意味着，如果源对象和目标对象的属性是对象类型（非基本数据类型），则它们在内存中引用的是同一个对象，而不是两个相互独立的对象。因此，如果修改了其中一个对象的属性，另一个对象的相应属性也会受到影响。

举例来说，假设源对象 source 和目标对象 target 都有一个属性 list，它们都引用同一个 ArrayList 对象。当使用 BeanUtils.copyProperties() 方法进行属性复制时，只会复制 list 属性的引用，而不会复制 ArrayList 对象本身。因此，如果修改了 source 对象的 list 属性，target 对象的 list 属性也会发生变化，因为它们引用的是同一个 ArrayList 对象。

如果需要进行深拷贝，即复制对象及其所有属性的副本，可以考虑使用其他工具或手动实现深拷贝逻辑，例如使用第三方库（如 Apache Commons BeanUtils 中的 BeanUtils.cloneBean() 方法）或手动递归复制对象的所有属性。

踩坑记录

1.属性名称和类型匹配问题

源对象和目标对象的属性名称要完全匹配，否则会导致部分属性无法复制或者属性值错误。另外，属性的类型也要保持一致，否则可能会发生类型转换异常。

2.深拷贝问题

BeanUtils.copyProperties() 方法进行的是浅拷贝，如果源对象的属性值是对象类型，并且被多个对象引用，那么目标对象的相应属性值也会引用同一个对象。这可能导致在修改一个对象的属性值时，其他对象的属性值也会受到影响。

java

代码解读

复制代码

//源对象 @Data public class SourceObject { private String name; private int age; private Map<String,String> map; } //目标对象 @Data public class TargetObject { private String name; private int age; private Map<String,String> map; }

这时目标对象确实赋值了。但是如果改变map对象，目标对象也会跟着改变。

3.null 值处理

默认情况下，BeanUtils.copyProperties() 方法会将源对象中的所有非 null 属性值复制到目标对象中。如果希望忽略源对象中的 null 属性值，可以使用 BeanUtils.copyProperties() 方法的重载版本，并设置 ignoreNullSource 参数为 true。