SpringBoot實(shí)現(xiàn)數(shù)據(jù)轉(zhuǎn)換的四種對象映射方案
更新時間：2025年06月03日 08:37:48 作者：風(fēng)象南
在項(xiàng)目開發(fā)中,對象之間的相互轉(zhuǎn)換是一個高頻操作,尤其在分層架構(gòu)的系統(tǒng)中,數(shù)據(jù)在實(shí)體對象(Entity)、數(shù)據(jù)傳輸對象(DTO)、值對象(VO)之間的轉(zhuǎn)換尤為常見,選擇一個高效、可靠的對象映射方案對提高系統(tǒng)性能和開發(fā)效率至關(guān)重要,本文將介紹4種對象映射方案
方案一：手動映射
手動映射是最基礎(chǔ)也是最直接的方法，通過顯式編寫代碼將一個對象的屬性復(fù)制到另一個對象。
實(shí)現(xiàn)方式
首先定義兩個示例類：
// 用戶實(shí)體類
@Entity
@Table(name = "users")
public class UserEntity {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
private String username;
private String password;
private String email;
private String phoneNumber;
private LocalDateTime createTime;
private LocalDateTime updateTime;
// getter和setter省略
}
// 用戶DTO類
public class UserDTO {
private Long id;
private String username;
private String email;
private String phone; // 注意命名差異
private LocalDateTime registerTime; // 映射自createTime
// getter和setter省略
}
手動映射實(shí)現(xiàn)：
public class UserMapper {
public static UserDTO toDTO(UserEntity entity) {
if (entity == null) {
return null;
}
UserDTO dto = new UserDTO();
dto.setId(entity.getId());
dto.setUsername(entity.getUsername());
dto.setEmail(entity.getEmail());
dto.setPhone(entity.getPhoneNumber()); // 不同名稱字段映射
dto.setRegisterTime(entity.getCreateTime()); // 語義轉(zhuǎn)換
return dto;
}
public static UserEntity toEntity(UserDTO dto) {
if (dto == null) {
return null;
}
UserEntity entity = new UserEntity();
entity.setId(dto.getId());
entity.setUsername(dto.getUsername());
entity.setEmail(dto.getEmail());
entity.setPhoneNumber(dto.getPhone()); // 不同名稱字段映射
entity.setCreateTime(dto.getRegisterTime()); // 語義轉(zhuǎn)換
return entity;
}
// 集合轉(zhuǎn)換方法
public static List<UserDTO> toDTOList(List<UserEntity> entities) {
if (entities == null) {
return Collections.emptyList();
}
return entities.stream()
.map(UserMapper::toDTO)
.collect(Collectors.toList());
}
}
優(yōu)缺點(diǎn)分析
優(yōu)點(diǎn)：
- 完全掌控映射邏輯，靈活性最高
- 不依賴第三方庫，無學(xué)習(xí)成本
- 映射邏輯清晰直觀，易于調(diào)試
- 性能最優(yōu)，無反射開銷
缺點(diǎn)：
- 代碼冗長，大量重復(fù)勞動
- 屬性變更需要手動同步修改轉(zhuǎn)換代碼
- 隨著對象數(shù)量增加，維護(hù)成本劇增
- 容易出現(xiàn)人為錯誤，如遺漏字段
方案二：MapStruct
MapStruct是一個代碼生成器，它基于約定優(yōu)于配置的方法，在編譯時生成類型安全的對象映射代碼。
實(shí)現(xiàn)方式
1. 添加依賴
<dependency>
<groupId>org.mapstruct</groupId>
<artifactId>mapstruct</artifactId>
<version>1.5.3.Final</version>
</dependency>
<dependency>
<groupId>org.mapstruct</groupId>
<artifactId>mapstruct-processor</artifactId>
<version>1.5.3.Final</version>
<scope>provided</scope>
</dependency>
2. 定義映射接口
@Mapper(componentModel = "spring")
public interface UserMapStruct {
@Mapping(source = "phoneNumber", target = "phone")
@Mapping(source = "createTime", target = "registerTime")
UserDTO toDTO(UserEntity entity);
@Mapping(source = "phone", target = "phoneNumber")
@Mapping(source = "registerTime", target = "createTime")
UserEntity toEntity(UserDTO dto);
List<UserDTO> toDTOList(List<UserEntity> entities);
// 默認(rèn)值處理
@Mapping(target = "email", defaultValue = "no-email@example.com")
UserDTO toDTOWithDefaultEmail(UserEntity entity);
// 自定義方法處理復(fù)雜轉(zhuǎn)換
default String formatPhoneNumber(String phoneNumber) {
if (phoneNumber == null || phoneNumber.trim().isEmpty()) {
return null;
}
// 格式化電話號碼邏輯
return phoneNumber.replaceAll("(\d{3})(\d{4})(\d{4})", "$1-$2-$3");
}
}
3. 使用方式
@Service
public class UserService {
private final UserMapStruct userMapper;
@Autowired
public UserService(UserMapStruct userMapper) {
this.userMapper = userMapper;
}
public UserDTO getUserDTO(Long id) {
UserEntity entity = userRepository.findById(id).orElseThrow();
return userMapper.toDTO(entity);
}
public List<UserDTO> getAllUserDTOs() {
List<UserEntity> entities = userRepository.findAll();
return userMapper.toDTOList(entities);
}
}
優(yōu)缺點(diǎn)分析
優(yōu)點(diǎn)：
- 編譯時生成代碼，運(yùn)行時性能極高
- 編譯時類型安全檢查，錯誤提前發(fā)現(xiàn)
- 代碼簡潔，開發(fā)效率高
- 支持復(fù)雜映射和自定義轉(zhuǎn)換邏輯
- 簡化集合映射，無需手動循環(huán)
缺點(diǎn)：
- 需要額外依賴和配置
- 調(diào)試相對復(fù)雜（需查看生成的代碼）
方案三：ModelMapper
ModelMapper是一個靈活、強(qiáng)大的對象映射庫，通過反射機(jī)制實(shí)現(xiàn)自動映射。
實(shí)現(xiàn)方式
1. 添加依賴
<dependency>
<groupId>org.modelmapper</groupId>
<artifactId>modelmapper</artifactId>
<version>3.1.1</version>
</dependency>
2. 配置ModelMapper
@Configuration
public class ModelMapperConfig {
@Bean
public ModelMapper modelMapper() {
ModelMapper modelMapper = new ModelMapper();
// 配置映射策略
modelMapper.getConfiguration()
.setMatchingStrategy(MatchingStrategies.STRICT)
.setPropertyCondition(Conditions.isNotNull())
.setFieldAccessLevel(Configuration.AccessLevel.PRIVATE)
.setFieldMatchingEnabled(true);
// 自定義字段映射
PropertyMap<UserEntity, UserDTO> userMap = new PropertyMap<UserEntity, UserDTO>() {
@Override
protected void configure() {
map().setPhone(source.getPhoneNumber());
map().setRegisterTime(source.getCreateTime());
}
};
modelMapper.addMappings(userMap);
return modelMapper;
}
}
3. 使用方式
@Service
public class UserService {
private final ModelMapper modelMapper;
private final UserRepository userRepository;
@Autowired
public UserService(ModelMapper modelMapper, UserRepository userRepository) {
this.modelMapper = modelMapper;
this.userRepository = userRepository;
}
public UserDTO getUserDTO(Long id) {
UserEntity entity = userRepository.findById(id).orElseThrow();
return modelMapper.map(entity, UserDTO.class);
}
public List<UserDTO> getAllUserDTOs() {
List<UserEntity> entities = userRepository.findAll();
return entities.stream()
.map(entity -> modelMapper.map(entity, UserDTO.class))
.collect(Collectors.toList());
}
public UserEntity createUser(UserDTO dto) {
UserEntity entity = modelMapper.map(dto, UserEntity.class);
return userRepository.save(entity);
}
}
優(yōu)缺點(diǎn)分析
優(yōu)點(diǎn)：
- 使用簡單，API友好
- 配置靈活，支持多種映射策略
- 運(yùn)行時動態(tài)映射，無需預(yù)定義
- 支持深層映射和復(fù)雜對象圖
- 類型轉(zhuǎn)換內(nèi)置支持
缺點(diǎn)：
- 基于反射，性能要求極高的場景可能不適合
- 運(yùn)行時類型不安全，可能產(chǎn)生運(yùn)行時異常
- 映射邏輯不直觀，調(diào)試?yán)щy
- 復(fù)雜映射需要額外配置
方案四：Spring BeanUtils和BeanCopier
Spring框架提供了多種Bean屬性復(fù)制工具，其中BeanUtils是基于反射的，而BeanCopier是基于字節(jié)碼生成的高性能方案。
實(shí)現(xiàn)方式
1. Spring BeanUtils
import org.springframework.beans.BeanUtils;
public class UserMapperWithBeanUtils {
public static UserDTO toDTO(UserEntity entity) {
if (entity == null) {
return null;
}
UserDTO dto = new UserDTO();
// 復(fù)制相同名稱的屬性
BeanUtils.copyProperties(entity, dto);
// 手動處理不同名稱的屬性
dto.setPhone(entity.getPhoneNumber());
dto.setRegisterTime(entity.getCreateTime());
return dto;
}
public static UserEntity toEntity(UserDTO dto) {
if (dto == null) {
return null;
}
UserEntity entity = new UserEntity();
BeanUtils.copyProperties(dto, entity);
// 手動處理不同名稱的屬性
entity.setPhoneNumber(dto.getPhone());
entity.setCreateTime(dto.getRegisterTime());
return entity;
}
public static List<UserDTO> toDTOList(List<UserEntity> entities) {
if (entities == null) {
return Collections.emptyList();
}
return entities.stream()
.map(UserMapperWithBeanUtils::toDTO)
.collect(Collectors.toList());
}
}
2. CGLib BeanCopier
import org.springframework.cglib.beans.BeanCopier;
public class UserMapperWithBeanCopier {
// 創(chuàng)建并緩存BeanCopier實(shí)例，提高性能
private static final BeanCopier ENTITY_TO_DTO = BeanCopier.create(UserEntity.class, UserDTO.class, false);
private static final BeanCopier DTO_TO_ENTITY = BeanCopier.create(UserDTO.class, UserEntity.class, false);
public static UserDTO toDTO(UserEntity entity) {
if (entity == null) {
return null;
}
UserDTO dto = new UserDTO();
// 復(fù)制相同名稱的屬性
ENTITY_TO_DTO.copy(entity, dto, null);
// 手動處理不同名稱的屬性
dto.setPhone(entity.getPhoneNumber());
dto.setRegisterTime(entity.getCreateTime());
return dto;
}
public static UserEntity toEntity(UserDTO dto) {
if (dto == null) {
return null;
}
UserEntity entity = new UserEntity();
DTO_TO_ENTITY.copy(dto, entity, null);
// 手動處理不同名稱的屬性
entity.setPhoneNumber(dto.getPhone());
entity.setCreateTime(dto.getRegisterTime());
return entity;
}
}
優(yōu)缺點(diǎn)分析
Spring BeanUtils
優(yōu)點(diǎn)：
- 開箱即用，無需額外依賴
- 使用簡單，API簡潔
- 內(nèi)置在Spring框架中
- 支持屬性忽略功能
缺點(diǎn)：
- 基于反射，性能要求極高的場景可能不適合
- 僅支持相同名稱的屬性自動復(fù)制
- 不同名稱屬性需手動處理
- 不支持深層嵌套對象自動映射
CGLib BeanCopier
優(yōu)點(diǎn)：
- 性能極高，接近手動映射
- 基于字節(jié)碼生成，避免反射開銷
- 緩存BeanCopier實(shí)例可進(jìn)一步提升性能
- Spring Boot默認(rèn)包含CGLib依賴
缺點(diǎn)：
- 只能復(fù)制名稱完全相同的屬性
- 不支持類型轉(zhuǎn)換
- 配置選項(xiàng)有限
- 不同名稱屬性仍需手動處理
- 文檔較少，使用門檻略高
總結(jié)
對象映射是Spring Boot應(yīng)用中的常見需求，選擇合適的映射方案能顯著提高開發(fā)效率和應(yīng)用性能。
根據(jù)項(xiàng)目規(guī)模、性能要求和團(tuán)隊(duì)熟悉度選擇合適的方案，同時注意映射過程中的深淺拷貝、循環(huán)引用等問題。
合理使用對象映射工具，可以大幅減少樣板代碼，提高代碼質(zhì)量和可維護(hù)性。
以上就是SpringBoot數(shù)據(jù)轉(zhuǎn)換的4種對象映射方案的詳細(xì)內(nèi)容，更多關(guān)于SpringBoot對象映射的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
SpringMVC使用MultipartResolver實(shí)現(xiàn)文件上傳
MultipartResolver 用于處理文件上傳，當(dāng)收到請求時 DispatcherServlet 的 checkMultipart() 方法會調(diào)用 MultipartResolver 的 isMultipart() 方法判斷請求中是否包含文件2023-02-02
本文主要介紹了Java中equalsIgnoreCase()方法的使用，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2023-04-04
這篇文章主要介紹了Java的Spring框架下的AOP的作用，需要的朋友可以參考2017-04-04
IDEA是JetBrains公司推出一個集成開發(fā)工具，是Java開發(fā)工具中的翹楚，基于這個開發(fā)工具可以快速開發(fā)我們的Java相關(guān)項(xiàng)目，本文重點(diǎn)給大家介紹IDEA2022.2的簡介、下載與安裝、初步配置，感興趣的朋友一起看看吧2022-11-11
本文主要介紹了springboot 接口返回字符串帶引號的問題解決，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2022-04-04
今天小編就為大家分享一篇解決java junit單元測試@Test報錯的問題，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2018-11-11
這篇文章主要介紹了Java如何通過反射獲取對象的屬性和值問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-02-02
這篇文章主要介紹了Spring Properties的使用和配置方法,本文不是原理分析、源碼分析文章，只是希望可以幫助讀者更好地理解和使用 Spring Properties，有興趣的可以了解一下2018-01-01
SpringCloud整合Netty集群實(shí)現(xiàn)WebSocket的示例代碼
文章主要介紹了SpringCloud整合Netty集群實(shí)現(xiàn)WebSocket的相關(guān)內(nèi)容,包括服務(wù)注冊和發(fā)現(xiàn)中心的配置,如使用Nacos、CommandLineRunner啟動Netty服務(wù)等,還介紹了通過Redis實(shí)現(xiàn)消息發(fā)布訂閱的機(jī)制,需要的朋友可以參考下2024-11-11
這篇文章主要介紹了Java實(shí)現(xiàn)的簡易記事本,較為詳細(xì)的分析了基于java實(shí)現(xiàn)記事本程序的完整過程,具有一定參考借鑒價值,需要的朋友可以參考下2022-06-06