BeanUtils.copyProperties

作用

用于将一个 Java Bean(对象)的属性复制到另一个 Java Bean 中

使用场景

⭐属性复制:BeanUtil.copyProperties可以将一个对象中的属性值复制到另一个对象中,类似于Spring的BeanUtils和Apache Commons的BeanUtils。
⭐忽略空值:Hutool的BeanUtil提供了可以忽略空值属性的复制选项,这样就不会覆盖目标对象中的非空属性。
⭐支持不同类型的对象:源对象和目标对象可以是不同的类,只要它们有相同的属性名和兼容的类型。
⭐支持嵌套属性复制:如果属性本身也是一个Java Bean,BeanUtil.copyProperties可以递归地复制这些嵌套的属性。

在代码中使用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
import cn.hutool.core.bean.BeanUtil;

public class Example {
public static void main(String[] args) {
SourceBean source = new SourceBean();
source.setName("Alice");
source.setAge(25);
source.setAddress("Wonderland");

TargetBean target = new TargetBean();
target.setName("Bob"); // 目标对象原有的值

// 复制属性,忽略空值
BeanUtil.copyProperties(source, target, true);

System.out.println(target.getName()); // 输出: Alice
System.out.println(target.getAge()); // 输出: 25
System.out.println(target.getAddress()); // 输出: Wonderland
}
}

class SourceBean {
private String name;
private int age;
private String address;

// Getters and setters
}

class TargetBean {
private String name;
private int age;
private String address;

// Getters and setters
}

注意事项

⭐忽略空值:copyProperties的第三个参数可以设置为true,这样在复制属性时会忽略源对象中的空值,不会覆盖目标对象中已有的值。
⭐简单易用:Hutool的BeanUtil.copyProperties方法使用简单,代码更简洁,并且不需要捕获异常(如Apache Commons的BeanUtils)。
⭐性能优化:相比其他类似工具,Hutool在内部实现上对性能做了优化,尤其是在大批量对象属性复制的情况下。