脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → java → 使用MapStruct进行Java Bean映射

使用MapStruct进行Java Bean映射的方式

 更新时间：2025年02月08日 15:20:06   作者：微笑听雨。  
MapStruct是一个用于JavaBean映射的注解处理器,它通过注解生成类型安全且性能优异的映射代码,避免手动编写重复的样板代码,主要特性包括类型安全、高性能、简洁和可定制性,使用步骤包括定义映射接口、创建源类和目标类、生成映射代码并调用映射方法

使用MapStruct进行Java Bean映射的指南

简介

MapStruct 是一个用于 Java Bean 映射的注解处理器。它通过注解生成类型安全且性能优异的映射代码，避免手动编写重复的样板代码，适用于将一个 Java Bean 类型转换为另一个 Java Bean 类型。

MapStruct的主要特性

  1. 类型安全: 在编译时生成映射代码，避免运行时错误。
  2. 高性能: 生成的代码是纯 Java 代码，没有反射机制，性能非常高。
  3. 简洁: 减少了大量样板代码，开发者只需定义接口，MapStruct 自动生成实现。
  4. 可定制性: 支持自定义映射、默认值、转换方法等。

依赖配置

使用 MapStruct 需要添加相应的依赖。以 Maven 为例：

<dependencies>
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>1.5.0.Final</version>
    </dependency>
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
        <version>1.5.0.Final</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

如果使用 Gradle：

dependencies {
    implementation 'org.mapstruct:mapstruct:1.5.0.Final'
    annotationProcessor 'org.mapstruct:mapstruct-processor:1.5.0.Final'
}

MapStruct的使用步骤

定义映射接口

创建一个接口，并使用 @Mapper 注解标记它。

import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.ReportingPolicy;
import org.mapstruct.factory.Mappers;

/**
 * CarMapper 接口定义了 Car 和 CarDto 之间的映射关系。
 * 使用 @Mapper 注解标记接口，并设置 typeConversionPolicy 为 ReportingPolicy.ERROR，
 * 以确保类型转换不正确时编译报错。
 */
@Mapper(typeConversionPolicy = ReportingPolicy.ERROR)
public interface CarMapper {
    CarMapper INSTANCE = Mappers.getMapper(CarMapper.class);

    /**
     * 将 Car 实体映射为 CarDto。
     * @param car 源 Car 对象
     * @return 映射后的 CarDto 对象
     */
    @Mapping(source = "numberOfSeats", target = "seatCount")
    @Mapping(source = "engine.type", target = "engineType")
    CarDto carToCarDto(Car car);
}

定义源类和目标类

/**
 * Car 实体类
 */
public class Car {
    private String make; // 制造商
    private int numberOfSeats; // 座位数
    private Engine engine; // 引擎

    // getters 和 setters
}

/**
 * CarDto 数据传输对象
 */
public class CarDto {
    private String make; // 制造商
    private int seatCount; // 座位数
    private String engineType; // 引擎类型

    // getters 和 setters
}

/**
 * Engine 实体类
 */
public class Engine {
    private String type; // 引擎类型

    // getters 和 setters
}

生成映射代码

使用构建工具（如 Maven 或 Gradle）执行构建过程，MapStruct 将根据接口定义生成相应的映射实现类。

/**
 * CarMapper 的实现类，由 MapStruct 自动生成。
 */
public class CarMapperImpl implements CarMapper {
    @Override
    public CarDto carToCarDto(Car car) {
        if (car == null) {
            return null;
        }
        CarDto carDto = new CarDto();
        carDto.setMake(car.getMake());
        carDto.setSeatCount(car.getNumberOfSeats());
        if (car.getEngine() != null) {
            carDto.setEngineType(car.getEngine().getType());
        }
        return carDto;
    }
}

调用映射方法

/**
 * 演示如何使用 CarMapper 将 Car 实体映射为 CarDto。
 */
public class Main {
    public static void main(String[] args) {
        Car car = new Car();
        car.setMake("Toyota");
        car.setNumberOfSeats(5);
        Engine engine = new Engine();
        engine.setType("V8");
        car.setEngine(engine);

        CarDto carDto = CarMapper.INSTANCE.carToCarDto(car);
        System.out.println(carDto);
    }
}

深拷贝和浅拷贝

  • 浅拷贝: 复制对象的基本数据类型属性和引用类型属性的引用，引用类型属性本身并没有被复制。
  • 深拷贝: 复制对象的所有属性，包括引用类型属性所引用的对象本身。

MapStruct 默认进行浅拷贝，即引用类型属性在目标对象中会引用源对象的相同实例。如果需要进行深拷贝，可以手动编写自定义映射方法。

集合拷贝

MapStruct 可以自动处理集合类型的映射。例如：

import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.ReportingPolicy;
import org.mapstruct.factory.Mappers;

import java.util.List;

/**
 * CarMapper 接口定义了 Car 和 CarDto 之间的映射关系。
 * 使用 @Mapper 注解标记接口，并设置 typeConversionPolicy 为 ReportingPolicy.ERROR，
 * 以确保类型转换不正确时编译报错。
 */
@Mapper(typeConversionPolicy = ReportingPolicy.ERROR)
public interface CarMapper {
    CarMapper INSTANCE = Mappers.getMapper(CarMapper.class);

    /**
     * 将 Car 实体映射为 CarDto。
     * @param car 源 Car 对象
     * @return 映射后的 CarDto 对象
     */
    @Mapping(source = "numberOfSeats", target = "seatCount")
    @Mapping(source = "engine.type", target = "engineType")
    CarDto carToCarDto(Car car);

    /**
     * 将 Car 实体列表映射为 CarDto 列表。
     * @param cars 源 Car 对象列表
     * @return 映射后的 CarDto 对象列表
     */
    List<CarDto> carsToCarDtos(List<Car> cars);
}

编译时错误处理

MapStruct 在编译时进行类型检查，如果映射不正确，会抛出编译错误。可以使用 @Mapper 注解的 typeConversionPolicy 属性来配置在类型转换过程中遇到错误时的行为，例如 ReportingPolicy.ERROR。

import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.ReportingPolicy;
import org.mapstruct.factory.Mappers;

/**
 * CarMapper 接口定义了 Car 和 CarDto 之间的映射关系。
 * 使用 @Mapper 注解标记接口，并设置 typeConversionPolicy 为 ReportingPolicy.ERROR，
 * 以确保类型转换不正确时编译报错。
 */
@Mapper(typeConversionPolicy = ReportingPolicy.ERROR)
public interface CarMapper {
    CarMapper INSTANCE = Mappers.getMapper(CarMapper.class);

    /**
     * 将 Car 实体映射为 CarDto。
     * @param car 源 Car 对象
     * @return 映射后的 CarDto 对象
     */
    @Mapping(source = "numberOfSeats", target = "seatCount")
    CarDto carToCarDto(Car car);
}

在上述示例中，如果类型转换不正确或者无法转换，编译时将会报错，从而确保所有类型转换都得到正确处理。

完整示例与文档生成

以下是一个完整的示例，包括源代码和生成的映射代码，以及如何生成文档。

源代码

源类和目标类:

/**
 * Car 实体类
 */
public class Car {
    private String make; // 制造商
    private int numberOfSeats; // 座位数
    private Engine engine; // 引擎

    // getters 和 setters
}

/**
 * CarDto 数据传输对象
 */
public class CarDto {
    private String make; // 制造商
    private int seatCount; // 座位数
    private String engineType; // 引擎类型

    // getters 和 setters
}

/**
 * Engine 实体类
 */
public class Engine {
    private String type; // 引擎类型

    // getters 和 setters
}

映射接口:

import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.ReportingPolicy;
import org.mapstruct.factory.Mappers;

import java.util.List;

/**
 * CarMapper 接口定义了 Car 和 CarDto 之间的映射关系。
 * 使用 @Mapper 注解标记接口，并设置 typeConversionPolicy 为 ReportingPolicy.ERROR，
 * 以确保类型转换不正确时编译报错。
 */
@Mapper(typeConversionPolicy = ReportingPolicy.ERROR)
public interface CarMapper {
    CarMapper INSTANCE = Mappers.getMapper(CarMapper.class);

    /**
     * 将 Car 实

体映射为 CarDto。
     * @param car 源 Car 对象
     * @return 映射后的 CarDto 对象
     */
    @Mapping(source = "numberOfSeats", target = "seatCount")
    @Mapping(source = "engine.type", target = "engineType")
    CarDto carToCarDto(Car car);

    /**
     * 将 Car 实体列表映射为 CarDto 列表。
     * @param cars 源 Car 对象列表
     * @return 映射后的 CarDto 对象列表
     */
    List<CarDto> carsToCarDtos(List<Car> cars);
}

生成的映射代码

MapStruct 将自动生成如下实现类：

/**
 * CarMapper 的实现类，由 MapStruct 自动生成。
 */
public class CarMapperImpl implements CarMapper {
    @Override
    public CarDto carToCarDto(Car car) {
        if (car == null) {
            return null;
        }
        CarDto carDto = new CarDto();
        carDto.setMake(car.getMake());
        carDto.setSeatCount(car.getNumberOfSeats());
        if (car.getEngine() != null) {
            carDto.setEngineType(car.getEngine().getType());
        }
        return carDto;
    }

    @Override
    public List<CarDto> carsToCarDtos(List<Car> cars) {
        if (cars == null) {
            return null;
        }
        List<CarDto> list = new ArrayList<>(cars.size());
        for (Car car : cars) {
            list.add(carToCarDto(car));
        }
        return list;
    }
}

生成文档

可以使用 Javadoc 工具生成文档，示例如下：

javadoc -d doc -sourcepath src/main/java -subpackages com.example

生成的文档将包含所有类和接口的详细说明，包括字段、方法和注释。

总结

通过本指南，你可以了解 MapStruct 的基本特性、如何配置依赖、使用步骤、深拷贝和浅拷贝的区别、集合类型的映射以及如何处理编译时错误。

MapStruct 能极大地提高代码的可维护性和性能，是进行 Java Bean 映射的有力工具。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

相关文章

  • Java日常练习题,每天进步一点点(9)

    Java日常练习题,每天进步一点点(9)

    下面小编就为大家带来一篇Java基础的几道练习题(分享)。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧，希望可以帮到你
    2021-07-07
  • Java集合中的Collection接口总结

    Java集合中的Collection接口总结

    这篇文章主要介绍了Java集合中的Collection接口总结,Collection 接口是 List和Set接口的父接口,该接口里定义的方法既可用于操作 Set 集合,也可用于操作 List 集合,需要的朋友可以参考下
    2023-11-11
  • 关于java.io.EOFException产生的原因以及解决方案

    关于java.io.EOFException产生的原因以及解决方案

    文章总结：EOFException异常通常发生在尝试从空的ObjectInputStream对象中读取数据时,解决方法是在finally语句中添加判断,确保objectInputStream不为空后再进行关闭操作,在处理1.txt文件为空的情况时,捕获EOFException可以避免程序终止,并且不会抛出空指针异常
    2025-01-01
  • SpringBoot配置logback.xml 多环境的操作步骤

    SpringBoot配置logback.xml 多环境的操作步骤

    最近在研究springboot的日志，所以记录一下，做一下总结，今天重点给大家介绍SpringBoot配置logback.xml 多环境的操作步骤，要实现多环境的配置，主要是依赖于springboot的application.yml文件去实现，感兴趣的朋友跟随小编一起看看吧
    2021-05-05
  • JavaWeb后台购物车类实现代码详解

    JavaWeb后台购物车类实现代码详解

    这篇文章主要介绍了JavaWeb后台购物车类实现代码详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-07-07
  • Java 什么是注解及注解原理详细介绍

    Java 什么是注解及注解原理详细介绍

    这篇文章主要介绍了Java 注解的原理实例详解的相关资料,需要的朋友可以参考下
    2016-12-12
  • SpringBoot+MyBatis-Plus进行分页查询与优化

    SpringBoot+MyBatis-Plus进行分页查询与优化

    这篇文章主要为大家详细介绍了SpringBoot如何整合MyBatis-Plus进行分页查询与优化,文中的示例代码讲解详细,感兴趣的小伙伴可以参考一下
    2025-04-04
  • java二路归并排序示例分享

    java二路归并排序示例分享

    这篇文章主要介绍了java二路归并排序示例,需要的朋友可以参考下
    2014-02-02
  • 基于Feign实现异步调用

    基于Feign实现异步调用

    近期,需要对之前的接口进行优化,缩短接口的响应时间,但是springcloud中的feign是不支持传递异步化的回调结果的,因此有了以下的解决方案,记录一下,需要的朋友可以参考下
    2021-05-05
  • SpringBoot中@ConditionalOnProperty的使用及作用详解

    SpringBoot中@ConditionalOnProperty的使用及作用详解

    这篇文章主要介绍了SpringBoot中@ConditionalOnProperty的使用及作用详解,@ConditionalOnProperty通过读取本地配置文件中的值来判断 某些 Bean 或者 配置类 是否加入spring 中,需要的朋友可以参考下
    2024-01-01

最新评论