快捷導(dǎo)航

Java對象字段拷貝最佳實踐分享

更新時間：2025年03月03日 08:29:15 作者：碼農(nóng)研究僧

文章介紹了幾種常見的對象字段拷貝方法,包括手動set、BeanUtils.copyProperties、Lombok的@Builder和MapStruct,每種方法都有其優(yōu)缺點和適用場景,推薦使用MapStruct,因為它在編譯期生成代碼,性能最優(yōu),支持復(fù)雜對象映射,需要的朋友可以參考下

前言

一開始在線表和歷史表都是一張表，只不過字段設(shè)置不一樣，顯示不一樣

但后續(xù)數(shù)據(jù)越來越多，為了不影響在線表，數(shù)據(jù)最終得落入歷史表，不影響在線表的CRUD

以下章節(jié)圍繞如何克隆在線表的數(shù)據(jù)

對象字段拷貝的需求，比如從數(shù)據(jù)庫查詢出的對象需要轉(zhuǎn)換成 DTO，或者在審核流程中更新一張表的同時寫入歷史表等

如果手動 set 字段，代碼會變得繁瑣，難以維護

1. 傳統(tǒng)set（不推薦）

最簡單的方法是手動賦值，但是當(dāng)字段較多時，代碼冗長且容易遺漏。

示例代碼：

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

缺點：

代碼冗長：如果 CheckBoxDO有幾十個字段，手寫 set 非常麻煩
易出錯：如果 CheckBoxDO結(jié)構(gòu)變化，必須手動修改所有 set 邏輯，維護成本高

適用場景：

字段較少（少于 3 個字段）

除了set，還有一種跟他很像，我也放在這個章節(jié)

Lombok 的 @Builder，可以使用 builder() 方法來鏈?zhǔn)劫x值，提高可讀性（但我感覺沒啥差異）

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); // 額外賦值

優(yōu)點：

代碼簡潔，自動拷貝相同字段，避免手動 set
無需額外依賴，Spring 內(nèi)置

缺點：

性能一般，使用了反射，比手動 set 慢
字段名必須完全匹配，如果 CheckBoxDetailDO 和 CheckBoxDO字段名不一樣，無法拷貝
不支持復(fù)雜轉(zhuǎn)換，比如數(shù)據(jù)類型不同（int vs String）、默認(rèn)值設(shè)置等

適用場景：

字段名和類型完全匹配的簡單拷貝
項目已經(jīng)使用 Spring，避免額外依賴

3. MapStruct（推薦）

如果 CheckBoxDO和 CheckBoxDetailDO 結(jié)構(gòu)類似，并且字段較多，推薦使用 MapStruct 進行自動對象映射
MapStruct 在編譯期生成代碼，相比 BeanUtils 性能更優(yōu)，并且支持字段轉(zhuǎn)換

1、定義轉(zhuǎn)換接口

創(chuàng)建一個 Mapper 接口，并用 @Mapper 注解標(biāo)識。

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") // 強制設(shè)定 checkStatus 為 1
    CheckBoxDetailDO toDetailDO(CheckBoxDO checkBox);
}

2、調(diào)用轉(zhuǎn)換

@Resource
private ChekBoxDetailMapper chekBoxDetailMapper;

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

優(yōu)點：

高性能，編譯期生成代碼，沒有反射開銷
自動映射字段，省去 set 代碼
支持類型轉(zhuǎn)換，例如 String -> Long、Date -> LocalDateTime 等
字段名不同也能映射，可以用 @Mapping(source = “oldField”, target = “newField”) 自定義映射關(guān)系

缺點：

需要引入 MapStruct 依賴，但一次配置，終身受益

適用場景：

字段較多且映射規(guī)則較復(fù)雜
項目對性能要求較高（比 BeanUtils 更快）

但是會有bug：

后續(xù)發(fā)現(xiàn)id自增字段也被復(fù)刻了！

采取忽略的方式：

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

    @Mapping(target = "id", ignore = true) // 忽略 id 字段
    @Mapping(target = "checkStatus", constant = "1L") // 強制設(shè)定 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); // 插入數(shù)據(jù)庫

4. 總結(jié)

方案	代碼簡潔度	性能	適用場景
手動 set	? 差	?	快
BeanUtils.copyProperties	? 好	?一般	字段完全匹配，簡單拷貝
Lombok @Builder	? 好	? 快	代碼可讀性強，構(gòu)建新對象
MapStruct	? 最優(yōu)	? 最優(yōu)	復(fù)雜對象映射，性能高