BeanUtils.copyProperties(target, source)-在两个 Java 对象之间复制属性值

已于 2025-04-18 15:42:08 修改
阅读量985 收藏 8
点赞数 21
分类专栏： 项目工具类及问题解决 文章标签： java 复制属性值
于 2025-03-19 14:50:21 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/qq_41694906/article/details/146370873
版权

文章目录


BeanUtils.copyProperties 是 Apache Commons BeanUtils 库中的一个方法，用于在两个 Java 对象之间复制属性值。它通过反射机制动态地获取源对象的属性值，并将其赋值给目标对象的对应属性。

尽管 BeanUtils.copyProperties 非常方便，但它并不支持复杂对象的深度复制（deep copy）。为了更好地理解它的功能和限制，我们需要详细分析其工作原理、使用场景以及如何处理复杂对象。

1. 基本用法

BeanUtils.copyProperties 的基本语法如下：

import org.apache.commons.beanutils.BeanUtils;

public class Main {
    public static void main(String[] args) throws Exception {
        // 源对象
        Person source = new Person();
        source.setName("Alice");
        source.setAge(25);

        // 目标对象
        Person target = new Person();

        // 复制属性
        BeanUtils.copyProperties(target, source);

        // 输出结果
        System.out.println("Target Name: " + target.getName());
        System.out.println("Target Age: " + target.getAge());
    }
}

class Person {
    private String name;
    private int age;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

输出：

Target Name: Alice
Target Age: 25

解释：

  • BeanUtils.copyProperties(target, source) 将 source 对象的属性值复制到 target 对象。
  • 它会自动匹配源对象和目标对象中具有相同名称和兼容类型的属性。

2. 工作原理

BeanUtils.copyProperties 的工作流程如下：

  1. 通过反射获取属性 ：
  • 使用 Class.getDeclaredFields() 或类似的方法获取源对象的所有属性。
  • 检查目标对象是否具有相同名称的属性。
  1. 调用 getter 和 setter 方法 ：
  • 调用源对象的 getter 方法获取属性值。
  • 调用目标对象的 setter 方法设置属性值。
  1. 类型转换 ：
  • 如果源对象和目标对象的属性类型不同，BeanUtils 会尝试进行简单的类型转换（如 String 转 Integer）。

3. 支持简单对象的浅复制

BeanUtils.copyProperties 默认只支持浅复制（shallow copy），即它只会复制对象的字段值，而不会递归复制嵌套对象的字段。

示例：浅复制

class Address {
    private String city;

    public String getCity() {
        return city;
    }

    public void setCity(String city) {
        this.city = city;
    }
}

class Person {
    private String name;
    private Address address;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Address getAddress() {
        return address;
    }

    public void setAddress(Address address) {
        this.address = address;
    }
}

public class Main {
    public static void main(String[] args) throws Exception {
        // 创建源对象
        Address sourceAddress = new Address();
        sourceAddress.setCity("New York");

        Person source = new Person();
        source.setName("Bob");
        source.setAddress(sourceAddress);

        // 创建目标对象
        Person target = new Person();

        // 复制属性
        BeanUtils.copyProperties(target, source);

        // 修改源对象的地址
        source.getAddress().setCity("Los Angeles");

        // 输出结果
        System.out.println("Source City: " + source.getAddress().getCity());
        System.out.println("Target City: " + target.getAddress().getCity());
    }
}

输出：

Source City: Los Angeles
Target City: Los Angeles

解释：

  • BeanUtils.copyProperties 只复制了 address 引用，而不是创建一个新的 Address 对象。
  • 因此，修改源对象的 address.city 会影响目标对象的 address.city。

4. 不支持深度复制的原因

BeanUtils.copyProperties 不支持深度复制的主要原因在于：

  1. 引用传递 ：
  • 它直接将源对象的引用赋值给目标对象，导致两者共享同一个嵌套对象。
  1. 性能开销 ：
  • 深度复制需要递归遍历所有嵌套对象并创建新实例，这会显著增加性能开销。
  1. 复杂性 ：
  • 嵌套对象可能包含循环引用或复杂的结构，处理这些情况需要额外的逻辑。

5. 如何实现深度复制

如果需要深度复制，可以结合以下方法：

方法 1：手动实现深度复制

为每个类提供一个 clone 方法或类似的逻辑，递归复制所有嵌套对象。

class Address implements Cloneable {
    private String city;

    public String getCity() {
        return city;
    }

    public void setCity(String city) {
        this.city = city;
    }

    @Override
    protected Object clone() {
        Address cloned = new Address();
        cloned.setCity(this.city);
        return cloned;
    }
}

class Person implements Cloneable {
    private String name;
    private Address address;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Address getAddress() {
        return address;
    }

    public void setAddress(Address address) {
        this.address = address;
    }

    @Override
    protected Object clone() {
        Person cloned = new Person();
        cloned.setName(this.name);
        cloned.setAddress((Address) this.address.clone());
        return cloned;
    }
}

public class Main {
    public static void main(String[] args) throws Exception {
        // 创建源对象
        Address sourceAddress = new Address();
        sourceAddress.setCity("New York");

        Person source = new Person();
        source.setName("Charlie");
        source.setAddress(sourceAddress);

        // 深度复制
        Person target = (Person) source.clone();

        // 修改源对象的地址
        source.getAddress().setCity("San Francisco");

        // 输出结果
        System.out.println("Source City: " + source.getAddress().getCity());
        System.out.println("Target City: " + target.getAddress().getCity());
    }
}

输出：

Source City: San Francisco
Target City: New York

解释：

  • clone 方法递归复制了 Address 对象，确保源对象和目标对象的嵌套对象是独立的。

方法 2：使用第三方库（如 MapStruct 或 Jackson）

一些现代库（如 MapStruct 或 Jackson）支持深度复制，并且更加高效。

示例：使用 Jackson 进行深度复制

import com.fasterxml.jackson.databind.ObjectMapper;

class Address {
    private String city;

    public String getCity() {
        return city;
    }

    public void setCity(String city) {
        this.city = city;
    }
}

class Person {
    private String name;
    private Address address;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Address getAddress() {
        return address;
    }

    public void setAddress(Address address) {
        this.address = address;
    }
}

public class Main {
    public static void main(String[] args) throws Exception {
        ObjectMapper objectMapper = new ObjectMapper();

        // 创建源对象
        Address sourceAddress = new Address();
        sourceAddress.setCity("New York");

        Person source = new Person();
        source.setName("David");
        source.setAddress(sourceAddress);

        // 深度复制
        Person target = objectMapper.readValue(objectMapper.writeValueAsString(source), Person.class);

        // 修改源对象的地址
        source.getAddress().setCity("Chicago");

        // 输出结果
        System.out.println("Source City: " + source.getAddress().getCity());
        System.out.println("Target City: " + target.getAddress().getCity());
    }
}

输出：

Source City: Chicago
Target City: New York

解释：

  • Jackson 将对象序列化为 JSON，然后反序列化为目标对象，从而实现深度复制。

6. 总结

  • 浅复制 ：BeanUtils.copyProperties 默认只支持浅复制，适用于简单对象。
  • 深度复制 ：需要手动实现（如 clone 方法）或借助工具（如 Jackson）。
  • 适用场景 ：
  • 如果对象结构简单且不需要深度复制，可以直接使用 BeanUtils.copyProperties。
  • 如果对象包含嵌套结构或需要深度复制，建议使用 Jackson 或其他专用工具。

如果你有更具体的需求或问题，请进一步说明，我可以为你提供更详细的解决方案！

Spring BeanUtils.copyProperties实现机制
Enzo的探索之路
10-02 1155
Spring框架中的方法提供了一种在两个 Java 对象之间复制属性的便捷方式。与 Apache Commons BeanUtils 类似，它也是基于反射来实现的。
spring和apache的BeanUtils.copyProperties
учёба
10-25 1561
类别所在的包函数参数性能Apache较差Spring较好。
重写BeanUtils.copyProperties(复制对象属性方法)
漫长学习路
12-22 3万+
背景: 在电商项目中所需要的业务非常多，所以我们的业务数据也会有很多种，这个时候就会有什么VO,DTO,PO等等这些，把业务和我们的基础数据进行分离转换。但是一直都没有什么好一点的转换类。后来用了一下BeanUtils.copyPropertie，和PropertyUtils.copyProperties()的方法，发现其效率非常低。这里也简单总结了一下他们的用法及原理以及自己实现的转换类；
BeanUtils.copyProperties(source, target)
qq_39839828的博客
08-28 365
1：BeanUtils.copyProperties(source, target); 2：待拷贝的对象中的属性要添加@ApiField()注解 3：注意，如果source为null，则会报错 Exception in thread "main" java.lang.IllegalArgumentException: Source must not be null
BeanUtil.copyProperties(source,target)拷贝List注意事项
weixin_45876411的博客
01-31 2084
方法拷贝List属性时只是将source中List的引用拷贝给target中的List(source和target对象中的List本质上为同一个对象);已知上面对target对象中的List数据修改时会影响到source对象中的List数据;也清楚了出现这个问题的原因在于使用。
spring下的beanutils.copyProperties实现深拷贝
最新发布
qq_16570607的博客
12-06 1125
1.2、深拷贝 深拷贝就是将目标对象的属性全部复制一份给源对象，复制完之后他们就是隔开的，没有任何关系，无论操作源对象还是目标对象都对另一个没有影响 无论是浅拷贝还是深拷贝，对于基本类型和String来说都是没有影响的，有影响的只有引用类型数据。1.1、浅拷贝 浅拷贝可以理解为如果是引用类型，那么目标对象拷贝的只是源对象的地址，无论目标对象还是源对象改变，他们都会一起改变。
Java BeanUtils.copyProperties() 详解及应用
m0_73467713的博客
08-17 1万+
方法用于将一个 Java 对象的属性复制到另一个对象。它在处理数据传输对象（DTO）、视图对象（VO）和实体对象（Entity）之间的数据传递时非常有用。source：源对象，属性值从这个对象中提取。target：目标对象，将属性值复制到这个对象中。是一个强大的工具，可以简化对象属性的拷贝操作。它在 Java 开发中扮演着重要的角色，尤其是在对象转换、数据封装和自动化测试等场景中。虽然它提供了很大的便利，但在性能要求较高的情况下，可能需要评估其他解决方案。
Spring学习笔记（一）【BeanUtils.copyProperties方法】
Vinjcent
01-29 1万+
简单地说，拷贝就是将一个类中的属性拷贝到另一个中，对于BeanUtils.copyProperties来说，你必须保证属性名和类型是相同的，因为它是根据get和set方法来赋值的1.1、浅拷贝浅拷贝对于基本数据类型就是直接进行值传递，在内存的另一个空间内存放，修改这个值不会影响到拷贝源的值浅拷贝对于引用数据类型就是进行的是地址传递，并没有对该对象重新开辟一个内存空间进行存放，所以对于引用数据类型的浅拷贝就相当于两个引用指向了同一个内存地址。
如何使用BeanUtils.copyProperties进行对象之间的属性赋值
08-19
它的主要功能是将源对象（source）的所有可读属性值复制到目标对象（target）。如果源对象和目标对象有相同的属性，那么这些属性的值就会被赋值过去。需要注意的是，源对象和目标对象的属性名称必须完全匹配，且属性...
BeanUtils.copyProperties的用法
程序猿小九九的博客
05-13 959
记录BeanUtils.copyProperties的用法，快速赋值。方便简洁高效！
调研BeanUtils.copyProperties、BeanUtil.copy、Convert.convert类型转换拷贝
努力努力，努力努力的博客
07-29 3058
调研BeanUtils.copyProperties(source, target)、BeanUtil.copy(Object source, Object target)、Convert.convert(Class target, Object source)拷贝方法的使用效果。
BeanUtils.copyProperties()和JSONObject.parseObject()分别是哪种拷贝类型（浅拷贝 or 深拷贝）
qq_42449963的博客
07-16 1757
例子中的Info类以及属性Student类都没有实现Cloneable接口，也没有重写clone()方法，说它们是浅拷贝或者深拷贝意义不大，但是道理是差不多的，如果想搞懂什么是浅拷贝，什么是深拷贝，请观看引用拷贝、浅拷贝、深拷贝。.........
BeanUtils.copyProperties的使用(深拷贝，浅拷贝)
热门推荐
enthan809882的博客
03-18 13万+
这里说的是spring的BeanUtils.copyProperties。 场景 开发中经常遇到，把父类的属性拷贝到子类中。通常有2种方法： 1、一个一个set 2、用BeanUtils.copyProperties 很显然BeanUtils更加方便，也美观很多。 那么任何情况都能使用BeanUtils么，当然不是。要先了解他。 是深拷贝，还是浅拷贝? 是浅拷贝。 浅拷贝： 只是调用子对象的set...
Spring当中的BeanUtils.copyProperties方法是深拷贝还是浅拷贝?
qq_70095877的博客
05-28 1452
拷贝 : 顾名思义 ,在 Java当中就是 将一个类 的 属性 通过 get 和 set 方法来 赋值 给到 另一个类当中的属性 .浅拷贝 : 如果是引用类型 , 那么目标对象拷贝的只是源对象的地址 (无论目标对象还是源对象的改变 , 它们都会一起发生改变)[引用的一个内存地址]深拷贝 : 即将源对象的属性值 全部复制到 目标对象相应属性 (复制完之后,它们之间是隔开的 , 没有任何关系 , 无论操作源对象 还是目标对象 都是对另一个没有影响)[将子对象的属性也拷贝过去]
SPRING下的BEANUTILS.COPYPROPERTIES方法是深拷贝还是浅拷贝？可以实现深拷贝吗？
sky198989的博客
06-28 739
Spring拷贝
beanutils.copyproperties 将两个类的属性值 复制到一个类上
11-16
当你有两个 Java 对象，其中一个包含了你需要的属性值，并且你想把这些值复制到另一个对象上去，就可以利用 `copyProperties`。 例如，如果你有一个源对象 `sourceObject` 和一个目标对象 `targetObject`，你可以...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

苍煜

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值