Java中常见对象映射工具的使用详解

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

对象映射是 Java 开发中的重要环节,尤其在处理数据转换时,就需要将一种结构的数据转换为另一种结构的数据（例如 DTO 和 Entity 之间）,在这篇博客中,我们将认识并解析几种常用的对象映射工具,并提供详细样例,需要的朋友可以参考下

1、简述

对象映射是 Java 开发中的重要环节，尤其在处理数据转换时，就需要将一种结构的数据转换为另一种结构的数据（例如 DTO 和 Entity 之间）。在这篇博客中，我们将认识并解析几种常用的对象映射工具，并提供详细样例。

2、对象映射工具概览

常见的对象映射工具包括：

MapStruct：基于源代码生成器的快速工具，实现高性能对象转换。
ModelMapper：一个自动映射对象之间完全解耗的工具。
Dozer：一个压力对象转换工具，支持深度转换和自定义规则。
BeanUtils：Spring 提供的基础工具，适合处理简单对象映射。

2.1 MapStruct

MapStruct 是一个基于源代码生成的对象映射工具，以高性能和便捷且实现为人举。它在编译时生成代码，需要配合规范地实现映射。

定义 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
    }
}

注意事项：

BeanUtils 不支持深拷贝，只能拷贝一层属性。
属性名必须完全匹配，否则会被忽略。
适合简单场景，复杂场景推荐使用 MapStruct 或 ModelMapper。

3、总结

在 Java 开发中，不同的对象映射工具适用于不同的场景：

MapStruct：适合高性能和类型安全要求高的项目，推荐用于复杂映射。
ModelMapper：适合自动化程度高、需要快速上手的场景，但性能稍逊。
Dozer：支持复杂的深层次映射，适用于需要高级自定义的场景。
BeanUtils：适合简单的对象属性复制场景，但不支持深拷贝。

选择合适的工具需要根据项目的具体需求和场景进行权衡，希望本文的解析和示例能够帮助您更好地理解和应用这些工具！

到此这篇关于Java中常见对象映射工具的使用详解的文章就介绍到这了,更多相关Java对象映射工具内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

SpringBoot实现文件上传服务器全过程
该文章详细描述了如何纯手工实现一个SpringBoot文件上传功能,包括引入必要的依赖、创建实体类、编写服务层代码、实现文件上传逻辑以及使用Controller进行测试,通过自定义文件路径和将文件名修改为UUID,有效避免了文件名重复的问题
2025-12-12
详解Spring数据缓存注解@Cacheable、@CachePut、@CacheEvict
这篇文章主要介绍了详解Spring数据缓存注解@Cacheable、CachePut、@CacheEvict,当以一组参数第一次调用某个方法时，返回值会被保存在缓存中，如果这个方法再次以相同的参数进行调用时，这个返回值会从缓存中查询获取,需要的朋友可以参考下
2023-07-07
Java foreach在lambda的foreach遍历中退出操作(lambda foreach break)
本文详细讲解了在Java的中,特别是在使用forEach()方法时,无法直接使用break或continue关键字来直接控制循环流程的问题,以及提供了三种解决方案,包括使用异常中断、流式编程的limit()和原子布尔标志位,感兴趣的朋友跟随小编一起看看吧
2026-05-05
java.lang.OutOfMemoryError: Java heap space错误
本文主要介绍了java.lang.OutOfMemoryError: Java heap space错误的问题解决,包括内存泄漏、数据过大和JVM堆大小配置不足,提供了解决方法,具有一定的参考价值,感兴趣的可以了解一下
2025-03-03
java编程中字节流转换成字符流的实现方法
下面小编就为大家带来一篇java编程中字节流转换成字符流的实现方法。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-01-01
MyBatis3用log4j在控制台输出SQL的方法示例
本篇文章主要介绍了MyBatis3用log4j在控制台输出SQL的方法示例，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-01-01
深度分析java dump文件
java内存dump是jvm运行时内存的一份快照，利用它可以分析是否存在内存浪费，可以检查内存管理是否合理，当发生OOM的时候，可以找出问题的原因。那么dump文件的内容是什么样的呢？
2021-05-05
flink进阶富函数生命周期介绍
这篇文章主要为大家介绍了flink进阶富函数生命周期的举例介绍，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-03-03
Java实现读取设置pdf属性信息
这篇文章主要为大家详细介绍了如何使用Java实现读取设置pdf属性信息,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
2025-01-01
SpringBoot @InitBinder注解绑定请求参数的过程详解
这篇文章主要介绍了SpringBoot @InitBinder注解绑定请求参数,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2023-04-04