脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → java → Java对象字段拷贝

Java对象字段拷贝最佳实践分享

 更新时间：2025年03月03日 08:29:15   作者：码农研究僧  
文章介绍了几种常见的对象字段拷贝方法,包括手动set、BeanUtils.copyProperties、Lombok的@Builder和MapStruct,每种方法都有其优缺点和适用场景,推荐使用MapStruct,因为它在编译期生成代码,性能最优,支持复杂对象映射,需要的朋友可以参考下

前言

一开始在线表和历史表都是一张表，只不过字段设置不一样，显示不一样

但后续数据越来越多，为了不影响在线表，数据最终得落入历史表，不影响在线表的CRUD

以下章节围绕如何克隆在线表的数据

对象字段拷贝 的需求，比如从数据库查询出的对象需要转换成 DTO，或者在审核流程中更新一张表的同时写入历史表等

如果手动 set 字段，代码会变得繁琐，难以维护

1. 传统set（不推荐）

最简单的方法是 手动赋值，但是当字段较多时，代码冗长且容易遗漏。

示例代码：

CheckBoxDetailDO checkBoxDetailDO = new CheckBoxDetailDO();
checkBoxDetailDO.setCheckStatus(1L);
checkBoxDetailDO.setCntr(checkBox.getCntr());
checkBoxDetailDO.setImgCntrF(checkBox.getImgCntrF());
checkBoxDetailDO.setCreateTime(checkBox.getCreateTime());

缺点：

  • 代码冗长：如果 CheckBoxDO有几十个字段，手写 set 非常麻烦
  • 易出错：如果 CheckBoxDO结构变化，必须手动修改所有 set 逻辑，维护成本高

适用场景：

字段较少（少于 3 个字段）

除了set，还有一种跟他很像，我也放在这个章节

Lombok 的 @Builder，可以使用 builder() 方法来 链式赋值，提高可读性（但我感觉没啥差异）

CheckBoxDetailDO checkBoxDetailDO = CheckBoxDetailDO.builder()
        .checkStatus(1L)
        .cntr(checkBox.getCntr())
        .imgCntrF(checkBox.getImgCntrF())
        .createTime(checkBox.getCreateTime())
        .build();

2. copyProperties（有局限）

CheckBoxDetailDO checkBoxDetailDO = new CheckBoxDetailDO();
BeanUtils.copyProperties(checkBox, checkBoxDetailDO);
checkBoxDetailDO.setCheckStatus(1L); // 额外赋值

优点：

  • 代码简洁，自动拷贝 相同字段，避免手动 set
  • 无需额外依赖，Spring 内置

缺点：

  • 性能一般，使用了 反射，比手动 set 慢
  • 字段名必须完全匹配，如果 CheckBoxDetailDO 和 CheckBoxDO字段名不一样，无法拷贝
  • 不支持复杂转换，比如 数据类型不同（int vs String）、默认值设置 等

适用场景：

  • 字段名和类型完全匹配的简单拷贝
  • 项目已经使用 Spring，避免额外依赖

3. MapStruct（推荐）

如果 CheckBoxDO和 CheckBoxDetailDO 结构类似，并且字段较多，推荐使用 MapStruct 进行自动对象映射
MapStruct 在编译期生成代码，相比 BeanUtils 性能更优，并且支持字段转换

1、定义转换接口

创建一个 Mapper 接口，并用 @Mapper 注解标识。

import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.factory.Mappers;

@Mapper(componentModel = "spring")
public interface CheckBoxConverter {
    CheckBoxConverter INSTANCE = Mappers.getMapper(CheckBoxConverter.class);

    @Mapping(target = "checkStatus", constant = "1L") // 强制设定 checkStatus 为 1
    CheckBoxDetailDO toDetailDO(CheckBoxDO checkBox);
}

2、调用转换

@Resource
private ChekBoxDetailMapper chekBoxDetailMapper;

CheckBoxDetailDO checkBoxDetailDO = CheckBoxConverter.INSTANCE.toDetailDO(checkBox);
chekBoxDetailMapper.insert(checkBoxDetailDO);

优点：

  • 高性能，编译期生成代码，没有反射开销
  • 自动映射字段，省去 set 代码
  • 支持类型转换，例如 String -> Long、Date -> LocalDateTime 等
  • 字段名不同也能映射，可以用 @Mapping(source = “oldField”, target = “newField”) 自定义映射关系

缺点：

需要引入 MapStruct 依赖，但一次配置，终身受益

适用场景：

  • 字段较多且映射规则较复杂
  • 项目对性能要求较高（比 BeanUtils 更快）

但是会有bug：

后续发现id自增字段也被复刻了！

采取忽略的方式：

@Mapper
public interface CheckBoxConverter {
    CheckBoxConverter INSTANCE = Mappers.getMapper(CheckBoxConverter.class);

    @Mapping(target = "id", ignore = true) // 忽略 id 字段
    @Mapping(target = "checkStatus", constant = "1L") // 强制设定 checkStatus 为 1
    CheckBoxDetailDO toDetailDO(CheckBoxDO checkBox);
}

截图如下：

这里拓展下这种方式其他的知识点：

使用 @BeanMapping(ignoreByDefault = true)（仅拷贝指定字段）

类似如下代码：

@Mapper(componentModel = "spring")
public interface CheckBoxConverter {
    CheckBoxConverter INSTANCE = Mappers.getMapper(CheckBoxConverter.class);

    @BeanMapping(ignoreByDefault = true)
    @Mapping(target = "cntr", source = "cntr")
    @Mapping(target = "imgCntrF", source = "imgCntrF")
    @Mapping(target = "createTime", source = "createTime")
    @Mapping(target = "checkStatus", constant = "1L")
    CheckBoxDetailDO toDetailDO(CheckBox checkBox);
}

如果不想修改代码：

CheckBoxDetailDO checkBoxDetailDO = CheckBoxConverter.INSTANCE.toDetailDO(checkBox);
checkBoxDetailDO.setId(null); // 手动清除 id

最后，不要忘记insert，否则它只是一个对象，没有存储

CheckBoxDetailDO checkBoxDetailDO = CheckBoxConverter.INSTANCE.toDetailDO(checkBox);
checkBoxDetailMapper.insert(checkBoxDetailDO); // 插入数据库

4. 总结

方案代码简洁度性能适用场景
手动 set❌ 差✅快
BeanUtils.copyProperties✅ 好❌一般字段完全匹配，简单拷贝
Lombok @Builder✅ 好✅ 快代码可读性强，构建新对象
MapStruct✅ 最优✅ 最优复杂对象映射，性能高

以上就是Java对象字段拷贝最佳实践分享的详细内容，更多关于Java对象字段拷贝的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

相关文章

  • Spring Boot网络配置之server.address超详细讲解

    Spring Boot网络配置之server.address超详细讲解

    在Spring Boot中,我们可以通过配置server.address属性来指定应用程序绑定的IP地址,下面这篇文章主要介绍了Spring Boot网络配置之server.address的相关资料,需要的朋友可以参考下
    2025-09-09
  • Java中的CopyOnWriteArrayList原理详解

    Java中的CopyOnWriteArrayList原理详解

    这篇文章主要介绍了Java中的CopyOnWriteArrayList原理详解,如源码所示,CopyOnWriteArrayList和ArrayList一样,都在内部维护了一个数组,操作CopyOnWriteArrayList其实就是在操作内部的数组,需要的朋友可以参考下
    2023-12-12
  • Spring Cloud整合XXL-Job的示例代码

    Spring Cloud整合XXL-Job的示例代码

    这篇文章主要介绍了springcloud整合xxl-job的示例代码,主要分为四个过程，本文给大家介绍的非常详细，需要的朋友可以参考下
    2023-05-05
  • Springboot多数据源配置之整合dynamic-datasource方式

    Springboot多数据源配置之整合dynamic-datasource方式

    这篇文章主要介绍了Springboot多数据源配置之整合dynamic-datasource方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
    2023-03-03
  • Java接口回调和方法回调的简单实现步骤

    Java接口回调和方法回调的简单实现步骤

    这篇文章主要介绍了Java接口回调和方法回调的相关资料,接口回调是一种设计模式,实现三方解耦,调用者提供接口实现,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2025-03-03
  • 利用POI读取word、Excel文件的最佳实践教程

    利用POI读取word、Excel文件的最佳实践教程

    Apache POI 是用Java编写的免费开源的跨平台的 Java API，Apache POI提供API给Java程式对Microsoft Office格式档案读和写的功能。 下面这篇文章主要给大家介绍了关于利用POI读取word、Excel文件的最佳实践的相关资料，需要的朋友可以参考下。
    2017-11-11
  • IDEA使用GsonFormat完成JSON和JavaBean之间的转换

    IDEA使用GsonFormat完成JSON和JavaBean之间的转换

    这篇文章主要介绍了IDEA使用GsonFormat完成JSON和JavaBean之间的转换,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2021-03-03
  • 如何合理管控Java语言的异常

    如何合理管控Java语言的异常

    这篇文章主要介绍了如何合理管控Java语言的异常问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-05-05
  • 详解Java中restTemplate的使用

    详解Java中restTemplate的使用

    这篇文章主要为大家详细介绍了Java中restTemplate用法的相关资料，文中的示例代码讲解详细，对我们学习Java有一定的帮助，需要的可以参考一下
    2022-11-11
  • Java读取图片EXIF信息的方法

    Java读取图片EXIF信息的方法

    这篇文章主要介绍了Java读取图片EXIF信息的方法,较为详细的分析了图片EXIF信息的概念、功能及java读取EXIF信息的实现技巧,需要的朋友可以参考下
    2015-07-07

最新评论