什么是MapStruct？

最新推荐文章于 2025-04-11 14:44:18 发布

-Jared

最新推荐文章于 2025-04-11 14:44:18 发布

阅读量1.6k

点赞数

分类专栏： Java 文章标签： java spring

本文链接：https://blog.youkuaiyun.com/HIHE_i/article/details/117908193

版权

MapStruct是一个编译时生成映射代码的Java库，用于高效、安全地转换实体和DTO。它避免了手动编写get/set代码和反射，提供编译时类型安全和错误报告。通过@Mapper注解定义接口，MapStruct会自动生成实现类。在示例中，展示了如何导入依赖、创建Mapper接口，并介绍了@Mapper的不同组件类型选项。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、简介

现在的分布式系统中模块划分越来越细，不同模块的实体、DTO、DO等需要进行转换，这么多工程处理起来不是那么简单。

MapStruct 就是这样的一个属性映射插件，用于为Java Bean生成类型安全且高性能的映射。它基于编译阶段生成get/set代码，此实现过程中没有反射，不会造成额外的性能损失。只需要定义一个 Mapper 接口，MapStruct 就会自动实现这个映射接口，避免了繁琐的映射实现。

🍭 官网 - 🍖 Github - 🍤 官方示例

优点

与手工编写映射代码相比

MapStruct通过生成冗长且容易出错的代码来节省时间。

与动态映射框架相比

简单泛型智能转换；
效率高：无需手动 set/get 或 implements Serializable 以达到深拷贝；
性能更高：使用简单的 Java 方法调用代替反射；
编译时类型安全：只能映射相同名称或带映射标记的属性；
编译时产生错误报告：如果映射不完整（存在未被映射的目标属性）或映射不正确（找不到合适的映射方法或类型转换）则会在编译时抛出异常。

二、Demo

2.1 导入依赖

使用该插件主要需要导入两个包：

::: details Maven | Gradle

Maven

    <dependency>
        <groupId>org.mapstruct</groupId>
        <!-- jdk8以下就使用mapstruct -->
        <artifactId>mapstruct-jdk8</artifactId>
        <version>1.3.0.Final</version>
    </dependency>
				<!-- 注解处理器 -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
        <version>1.3.0.Final

最低0.47元/天解锁文章