Java中常見對象映射工具的使用詳解

更新時間：2025年03月26日 10:50:30 作者：拾荒的小海螺

對象映射是 Java 開發(fā)中的重要環(huán)節(jié),尤其在處理數據轉換時,就需要將一種結構的數據轉換為另一種結構的數據（例如 DTO 和 Entity 之間）,在這篇博客中,我們將認識并解析幾種常用的對象映射工具,并提供詳細樣例,需要的朋友可以參考下

1、簡述

對象映射是 Java 開發(fā)中的重要環(huán)節(jié)，尤其在處理數據轉換時，就需要將一種結構的數據轉換為另一種結構的數據（例如 DTO 和 Entity 之間）。在這篇博客中，我們將認識并解析幾種常用的對象映射工具，并提供詳細樣例。

2、對象映射工具概覽

常見的對象映射工具包括：

MapStruct：基于源代碼生成器的快速工具，實現高性能對象轉換。
ModelMapper：一個自動映射對象之間完全解耗的工具。
Dozer：一個壓力對象轉換工具，支持深度轉換和自定義規(guī)則。
BeanUtils：Spring 提供的基礎工具，適合處理簡單對象映射。

2.1 MapStruct

MapStruct 是一個基于源代碼生成的對象映射工具，以高性能和便捷且實現為人舉。它在編譯時生成代碼，需要配合規(guī)范地實現映射。

定義 DTO 和 Entity：

public class UserDTO {
    private String name;
    private int age;
    // getter、setter
}

public class UserEntity {
    private String name;
    private int age;
    // getter、setter
}

定義映射控制器：

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

    UserDTO entityToDto(UserEntity entity);

    UserEntity dtoToEntity(UserDTO dto);
}

使用映射器：

public class Main {
    public static void main(String[] args) {
        UserEntity entity = new UserEntity();
        entity.setName("John");
        entity.setAge(30);

        UserDTO dto = UserMapper.INSTANCE.entityToDto(entity);
        System.out.println(dto.getName()); // John
        System.out.println(dto.getAge());  // 30
    }
}

2.2 ModelMapper

ModelMapper 是一個自動格式化工具，適合處理復雜對象映射。

import org.modelmapper.ModelMapper;

public class Main {
    public static void main(String[] args) {
        ModelMapper modelMapper = new ModelMapper();

        UserEntity entity = new UserEntity();
        entity.setName("Alice");
        entity.setAge(25);

        UserDTO dto = modelMapper.map(entity, UserDTO.class);
        System.out.println(dto.getName()); // Alice
        System.out.println(dto.getAge());  // 25
    }
}

2.3 Dozer

Dozer 是一個壓力的 Java Bean 映射工具，支持復雜場景，例如深度屬性轉換。

安裝和配置 Dozer：

在 Maven 中添加依賴：

<dependency>
    <groupId>net.sf.dozer</groupId>
    <artifactId>dozer</artifactId>
    <version>6.5.0</version>
</dependency>

使用代碼：

import org.dozer.DozerBeanMapper;

public class Main {
    public static void main(String[] args) {
        DozerBeanMapper mapper = new DozerBeanMapper();

        UserEntity entity = new UserEntity();
        entity.setName("Bob");
        entity.setAge(28);

        UserDTO dto = mapper.map(entity, UserDTO.class);
        System.out.println(dto.getName()); // Bob
        System.out.println(dto.getAge());  // 28
    }
}

2.4 BeanUtils

BeanUtils 是 Spring Framework 提供的工具，實現簡單對象映射，適合屬性名相同且數據結構簡單的場景。

添加依賴：

如果已經引入 Spring Framework，無需額外添加依賴。否則，可添加以下依賴：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-beans</artifactId>
    <version>5.3.26</version>
</dependency>

使用代碼：

import org.springframework.beans.BeanUtils;

public class Main {
    public static void main(String[] args) {
        UserEntity entity = new UserEntity();
        entity.setName("Charlie");
        entity.setAge(35);

        UserDTO dto = new UserDTO();
        BeanUtils.copyProperties(entity, dto);

        System.out.println(dto.getName()); // Charlie
        System.out.println(dto.getAge());  // 35
    }
}

注意事項：