亚洲乱码中文字幕综合,中国熟女仑乱hd,亚洲精品乱拍国产一区二区三区,一本大道卡一卡二卡三乱码全集资源,又粗又黄又硬又爽的免费视频

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

 更新時間:2025年02月08日 15:20:06   作者:微笑聽雨。  
MapStruct是一個用于JavaBean映射的注解處理器,它通過注解生成類型安全且性能優(yōu)異的映射代碼,避免手動編寫重復的樣板代碼,主要特性包括類型安全、高性能、簡潔和可定制性,使用步驟包括定義映射接口、創(chuàng)建源類和目標類、生成映射代碼并調(diào)用映射方法

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

簡介

MapStruct 是一個用于 Java Bean 映射的注解處理器。它通過注解生成類型安全且性能優(yōu)異的映射代碼,避免手動編寫重復的樣板代碼,適用于將一個 Java Bean 類型轉(zhuǎn)換為另一個 Java Bean 類型。

MapStruct的主要特性

  1. 類型安全: 在編譯時生成映射代碼,避免運行時錯誤。
  2. 高性能: 生成的代碼是純 Java 代碼,沒有反射機制,性能非常高。
  3. 簡潔: 減少了大量樣板代碼,開發(fā)者只需定義接口,MapStruct 自動生成實現(xiàn)。
  4. 可定制性: 支持自定義映射、默認值、轉(zhuǎn)換方法等。

依賴配置

使用 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的使用步驟

定義映射接口

創(chuàng)建一個接口,并使用 @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,
 * 以確保類型轉(zhuǎn)換不正確時編譯報錯。
 */
@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; // 座位數(shù)
    private Engine engine; // 引擎

    // getters 和 setters
}

/**
 * CarDto 數(shù)據(jù)傳輸對象
 */
public class CarDto {
    private String make; // 制造商
    private int seatCount; // 座位數(shù)
    private String engineType; // 引擎類型

    // getters 和 setters
}

/**
 * Engine 實體類
 */
public class Engine {
    private String type; // 引擎類型

    // getters 和 setters
}

生成映射代碼

使用構(gòu)建工具(如 Maven 或 Gradle)執(zhí)行構(gòu)建過程,MapStruct 將根據(jù)接口定義生成相應的映射實現(xiàn)類。

/**
 * CarMapper 的實現(xiàn)類,由 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;
    }
}

調(diào)用映射方法

/**
 * 演示如何使用 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);
    }
}

深拷貝和淺拷貝

  • 淺拷貝: 復制對象的基本數(shù)據(jù)類型屬性和引用類型屬性的引用,引用類型屬性本身并沒有被復制。
  • 深拷貝: 復制對象的所有屬性,包括引用類型屬性所引用的對象本身。

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,
 * 以確保類型轉(zhuǎn)換不正確時編譯報錯。
 */
@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 屬性來配置在類型轉(zhuǎn)換過程中遇到錯誤時的行為,例如 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,
 * 以確保類型轉(zhuǎn)換不正確時編譯報錯。
 */
@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);
}

在上述示例中,如果類型轉(zhuǎn)換不正確或者無法轉(zhuǎn)換,編譯時將會報錯,從而確保所有類型轉(zhuǎn)換都得到正確處理。

完整示例與文檔生成

以下是一個完整的示例,包括源代碼和生成的映射代碼,以及如何生成文檔。

源代碼

源類和目標類:

/**
 * Car 實體類
 */
public class Car {
    private String make; // 制造商
    private int numberOfSeats; // 座位數(shù)
    private Engine engine; // 引擎

    // getters 和 setters
}

/**
 * CarDto 數(shù)據(jù)傳輸對象
 */
public class CarDto {
    private String make; // 制造商
    private int seatCount; // 座位數(shù)
    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,
 * 以確保類型轉(zhuǎn)換不正確時編譯報錯。
 */
@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 將自動生成如下實現(xiàn)類:

/**
 * CarMapper 的實現(xiàn)類,由 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

生成的文檔將包含所有類和接口的詳細說明,包括字段、方法和注釋。

總結(jié)

通過本指南,你可以了解 MapStruct 的基本特性、如何配置依賴、使用步驟、深拷貝和淺拷貝的區(qū)別、集合類型的映射以及如何處理編譯時錯誤。

MapStruct 能極大地提高代碼的可維護性和性能,是進行 Java Bean 映射的有力工具。

以上為個人經(jīng)驗,希望能給大家一個參考,也希望大家多多支持腳本之家。

相關文章

  • JSON反序列化Long變Integer或Double的問題及解決

    JSON反序列化Long變Integer或Double的問題及解決

    這篇文章主要介紹了JSON反序列化Long變Integer或Double的問題及解決方案,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教
    2022-01-01
  • 詳解Spring IOC 容器啟動流程分析

    詳解Spring IOC 容器啟動流程分析

    這篇文章主要介紹了Spring IOC 容器啟動流程分析,本文給大家介紹的非常詳細,具有一定的參考借鑒價值,需要的朋友可以參考下
    2019-08-08
  • Java Flink窗口觸發(fā)器Trigger的用法詳解

    Java Flink窗口觸發(fā)器Trigger的用法詳解

    Trigger(窗口觸發(fā)器)決定了窗口(由 WindowAssigner 產(chǎn)生)什么時候調(diào)用窗口處理函數(shù)??梢愿鶕?jù)指定的時間或數(shù)據(jù)元素條件來決定什么時候觸發(fā)。本文將詳細講講其用法,需要的可以參考一下
    2022-07-07
  • Spring MVC學習教程之視圖深入解析

    Spring MVC學習教程之視圖深入解析

    這篇文章主要給大家介紹了關于Spring MVC學習教程之視圖解析的相關資料,文中通過示例代碼介紹的非常詳細,對大家學習或使用spring mvc具有一定的參考學習價值,需要的朋友們下面來一起看看吧
    2018-11-11
  • Java利用LocalDate進行日期處理的完全指南

    Java利用LocalDate進行日期處理的完全指南

    這篇文章主要為大家詳細介紹了Java利用LocalDate進行日期處理的詳細教程,文中的示例代碼講解詳細,感興趣的小伙伴可以跟隨小編一起學習一下
    2025-03-03
  • 淺談list.removeAll()刪除失敗的原因及解決

    淺談list.removeAll()刪除失敗的原因及解決

    這篇文章主要介紹了淺談list.removeAll()刪除失敗的原因及解決方案,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧
    2020-12-12
  • java 實現(xiàn)發(fā)短信功能---騰訊云短信

    java 實現(xiàn)發(fā)短信功能---騰訊云短信

    如今發(fā)短信功能已經(jīng)成為互聯(lián)網(wǎng)公司的標配,接下來通過本文給大家介紹java 實現(xiàn)發(fā)短信功能---騰訊云短信 ,需要的朋友可以參考下
    2019-08-08
  • JavaEE Cookie的基本使用細節(jié)

    JavaEE Cookie的基本使用細節(jié)

    本章我們將學習會話跟蹤技術中的Cookie與Session,它在我們整個JavaEE的知識體系中是非常重要的,本節(jié)我們先介紹Cookie,廢話不多說,直接上正文
    2022-12-12
  • java實現(xiàn)Dijkstra最短路徑算法

    java實現(xiàn)Dijkstra最短路徑算法

    這篇文章主要為大家詳細介紹了java實現(xiàn)Dijkstra最短路徑算法,文中示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們可以參考一下
    2019-01-01
  • 詳解Java中的mapstruct插件使用

    詳解Java中的mapstruct插件使用

    mapstruct 的插件是專門用來處理 domin 實體類與 model 類的屬性映射的,我們只需定義 mapper 接口,mapstruct 在編譯的時候就會自動的幫我們實現(xiàn)這個映射接口,避免了麻煩復雜的映射實現(xiàn),對Java?mapstruct使用相關知識感興趣的朋友一起看看吧
    2022-04-04

最新評論