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对象映射工具内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Jmeter连接Mysql数据库实现过程详解
这篇文章主要介绍了Jmeter连接Mysql数据库实现过程详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-08-08
java IO流之输出流 OutputString()的使用
这篇文章主要介绍了java IO流之输出流 OutputString()的使用的相关资料,需要的朋友可以参考下
2016-12-12
Java读写pdf文件的详细实现方法
最近公司的项目中需要操作pdf文件,所以这里给大家总结下方法,这篇文章主要给大家介绍了关于Java读写pdf文件的详细实现方法,文中通过代码介绍的非常详细,需要的朋友可以参考下
2023-09-09
maven工程打包引入本地jar包的实现
我们需要将jar包发布到一些指定的第三方Maven仓库,本文主要介绍了maven工程打包引入本地jar包的实现,具有一定的参考价值,感兴趣的可以了解一下
2024-02-02
springmvc用于方法鉴权的注解拦截器的解决方案代码
这篇文章主要介绍了springmvc用于方法鉴权的注解拦截器的解决方案代码，具有一定借鉴价值，需要的朋友可以参考下。
2017-12-12
SpringBoot集成RocketMQ实现消息发送的三种方式
RocketMQ 支持3 种消息发送方式：同步（sync）、异步（async）、单向（oneway）,本文就将给大家介绍一下SpringBoot集成RocketMQ实现消息发送的三种方式文中有详细的代码示例,需要的朋友可以参考下
2023-09-09
SpringBoot依赖管理的源码解析
这篇文章主要介绍了SpringBoot依赖管理的源码解析,maven提供了一套依赖管理机制，通过在pom.xml定义坐标，通过坐标从互联网的中央仓库下载依赖的构件(jar包),规范去管理依赖所有构件,这就叫依赖管理,需要的朋友可以参考下
2023-04-04
mybatis中嵌套使用foreach需要注意的坑
在使用MyBatis进行数据库操作时,如果需要在一个大的foreach标签中嵌套另一个foreach,需要注意内层foreach的item属性不能与外层重复,如果出现重复,会导致绑定参数时找不到正确的参数,从而抛出异常
2024-09-09
简单记事本java源码实例
这篇文章主要介绍了简单记事本java源码,以一个完整的实例形式分析了记事本的Java实现方法,对于Java应用程序的开发有一定的参考借鉴价值,需要的朋友可以参考下
2014-11-11
SWT(JFace) 打印功能
SWT(JFace)体验之打印功能
2009-06-06