Java中的MapStruct的使用方法代碼實例

更新時間：2023年10月21日 09:45:08 作者：浪浪山的猿

這篇文章主要介紹了Java中的MapStruct的使用方法代碼實例,mapstruct是一種實體類映射框架,能夠通過Java注解將一個實體類的屬性安全地賦值給另一個實體類,有了mapstruct,只需要定義一個映射器接口,聲明需要映射的方法,需要的朋友可以參考下

一、MapStruct 簡介

mapstruct是一種實體類映射框架，能夠通過Java注解將一個實體類的屬性安全地賦值給另一個實體類。有了mapstruct，只需要定義一個映射器接口，聲明需要映射的方法，在編譯過程中，mapstruct會自動生成該接口的實現類，實現將源對象映射到目標對象的效果。

二、MapStruct 使用

切記：使用過程中遇到問題一定要看下面的必坑指南

1.引入依賴

        <dependency>
            <groupId>org.mapstruct</groupId>
            <artifactId>mapstruct</artifactId>
            <version>1.5.2.Final</version>
        </dependency>

這個依賴項會導入MapStruct的核心注釋。由于MapStruct在編譯時工作，并且會集成到像Maven和Gradle這樣的構建工具上，我們還必須在<build中/>標簽中添加一個插件maven-compiler-plugin，并在其配置中添加annotationProcessorPaths，該插件會在構建時生成對應的代碼。

   <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
              <!--以下為mapstruct所需配置--> 
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.5.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <annotationProcessorPaths>
                        <path>
                            <groupId>org.mapstruct</groupId>
                            <artifactId>mapstruct-processor</artifactId>
                            <version>1.5.2.Final</version>
                        </path>
                    </annotationProcessorPaths>
                </configuration>
            </plugin>
        </plugins>
    </build>

2. 基本映射

1.相同字段間映射

我們先從一些基本的映射開始。我們會創(chuàng)建一個UserInfo 對象和一個UserInfoDTO 對象，為了方便起見，它們的屬性字段都使用相同的名稱。

@Data
@TableName(value = "user_info")
public class UserInfo {
    private String id;
    private String name;
    private String sex;
    private String email;
}
@Data
public class UserInfoDTO {
    private String id;
    private String name;
    private String sex;
    private String email;
}

現在，為了在這兩者之間進行映射，我們要創(chuàng)建一個UserInfoConvert接口。對該接口使用@Mapper注解，MapStruct就會知道這是兩個類之間的映射器。

@Mapper
public interface UserInfoConvert {
    UserInfoConvert INSTANCE = Mappers.getMapper(UserInfoConvert.class);
    UserInfoDTO toDTO(UserInfo userInfo);
}

這段代碼中創(chuàng)建了一個UserInfoConvert類型的實例INSTANCE，在生成對應的實現代碼后，這就是我們調用的“入口”。

我們在接口中定義了toDTO()方法，該方法接收一個UserInfo實例為參數，并返回一個UserInfoDTO實例。這足以讓MapStruct知道我們想把一個UserInfo 實例映射到一個UserInfoDTO實例。

當我們構建/編譯應用程序時，MapStruct注解處理器插件會識別UserInfoConvert接口并為其生成一個實現類。

@Generated(
    value = "org.mapstruct.ap.MappingProcessor",
    date = "2022-07-19T14:15:05+0800",
    comments = "version: 1.5.2.Final, compiler: javac, environment: Java 1.8.0_181 (Oracle Corporation)"
)
public class UserInfoConvertImpl implements UserInfoConvert {
    @Override
    public UserInfoDTO toDTO(UserInfo userInfo) {
        if ( userInfo == null ) {
            return null;
        }
        UserInfoDTO userInfoDTO = new UserInfoDTO();
        return userInfoDTO;
    }
}

UserInfoConvertImpl 類中包含一個toDTO()方法，將我們的UserInfo 屬性值映射到userInfoDTO 的屬性字段中。如果要將UserInfo 實例映射到一個userInfoDTO 實例，可以這樣寫：

     UserInfoDTO userInfoDTO = UserInfoConvert.INSTANCE.toDTO(userInfo);

2.不同字段間映射

通常，模型和DTO的字段名不會完全相同。由于團隊成員各自指定命名，以及針對不同的調用服務，開發(fā)者對返回信息的打包方式選擇不同，名稱可能會有輕微的變化。

注意下面兩個實體中的email字段不一致

public class UserInfo {
    private String id;
    private String name;
    private String sex;
    private String email;
}
@Data
public class UserInfoDTO {
    private String id;
    private String name;
    private String sex;
    private String myEmail;
}

現在，我們需要讓 UserMapper 知道這里的不一致。我們可以使用 @Mapping 注解，并設置其內部的 source 和 target 標記分別指向不一致的兩個字段。

@Mapper
public interface UserInfoConvert {
    UserInfoConvert INSTANCE = Mappers.getMapper(UserInfoConvert.class);
    @Mapping(target = "myEmail", source = "email")
    UserInfoDTO toDTO(UserInfo userInfo);
}

生成的實現類

@Generated(
    value = "org.mapstruct.ap.MappingProcessor",
    date = "2022-07-19T15:22:09+0800",
    comments = "version: 1.5.2.Final, compiler: javac, environment: Java 1.8.0_181 (Oracle Corporation)"
)
public class UserInfoConvertImpl implements UserInfoConvert {
    @Override
    public UserInfoDTO toDTO(UserInfo userInfo) {
        if ( userInfo == null ) {
            return null;
        }
        UserInfoDTO userInfoDTO = new UserInfoDTO();
        // 注意這里,已經自動轉換了
        userInfoDTO.setMyEmail( userInfo.getEmail() );
        userInfoDTO.setId( userInfo.getId() );
        userInfoDTO.setName( userInfo.getName() );
        userInfoDTO.setSex( userInfo.getSex() );
        return userInfoDTO;
    }
}

三、避坑指南

1號坑

Error:(20, 5) java: No property named "***" exists in source parameter(s). Type "***" has no properties.

原因： annotationProcessorPaths中缺少lombok插件

  <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.5.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <annotationProcessorPaths>
                      <!--缺少lombok-->
                        <path>
                            <groupId>org.mapstruct</groupId>
                            <artifactId>mapstruct-processor</artifactId>
                            <version>1.5.2.Final</version>
                        </path>
                    </annotationProcessorPaths>
                </configuration>
            </plugin>
        </plugins>
    </build>

解決辦法：annotationProcessorPaths中加上lombok插件

      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.5.1</version>
        <configuration>
            <source>1.8</source>
            <target>1.8</target>
            <annotationProcessorPaths>
                <path>
                    <groupId>org.projectlombok</groupId>
                    <artifactId>lombok</artifactId>
                    <version>1.18.20</version>
                </path>
                <path>
                    <groupId>org.mapstruct</groupId>
                    <artifactId>mapstruct-processor</artifactId>
                    <version>1.5.2.Final</version>
                </path>
            </annotationProcessorPaths>
        </configuration>
    </plugin>

2號坑

Error:(20, 5) java: No property named "***" exists in source parameter(s). Type "***" has no properties.

如果annotationProcessorPaths有l(wèi)ombok和mapstruct-processor，查看lombok是否放在mapstruct-processor后面，切記lombok要放在mapstruct-processor之前。

錯誤方式：

    <annotationProcessorPaths>
        <path>
            <groupId>org.mapstruct</groupId>
            <artifactId>mapstruct-processor</artifactId>
            <version>1.5.2.Final</version>
        </path>
        <path>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.20</version>
        </path>
    </annotationProcessorPaths>

正確方式：

    <annotationProcessorPaths>
       <path>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.20</version>
        </path>
        <path>
            <groupId>org.mapstruct</groupId>
            <artifactId>mapstruct-processor</artifactId>
            <version>1.5.2.Final</version>
        </path>
    </annotationProcessorPaths>

到此這篇關于Java中的MapStruct的使用方法代碼實例的文章就介紹到這了,更多相關MapStruct的使用方法內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

kaptcha驗證碼使用方法詳解
這篇文章主要為大家詳細介紹了kaptcha驗證碼的使用方法，具有一定的參考價值，感興趣的小伙伴們可以參考一下
2018-12-12
Spring解決循環(huán)依賴問題的三種方法小結
在 Spring 中,循環(huán)依賴問題指的是兩個或多個 bean 之間相互依賴形成的閉環(huán),具體而言,當 bean A 依賴于 bean B,同時 bean B 也依賴于 bean A,就形成了循環(huán)依賴,本文就給大家介紹了Spring解決循環(huán)依賴問題的三種方法,需要的朋友可以參考下
2023-09-09
解決微服務中關于用戶token處理到的坑
這篇文章主要介紹了解決微服務中關于用戶token處理到的坑，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教
2021-08-08
Java監(jiān)聽POST請求的示例詳解
要監(jiān)聽POST請求,我們可以使用Java中的HttpServlet類,以下是一個使用Servlet API監(jiān)聽POST請求的完整示例,通過代碼示例講解的非常詳細,具有一定的參考價值,需要的朋友可以參考下
2024-12-12
java通過注解翻譯字典的實現示例
本文主要介紹了java通過注解翻譯字典的實現示例，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下
2022-04-04
springboot中在非bean類中調用bean的實現方法
在Spring Boot中,非Bean類調用Bean方法通常需要通過靜態(tài)方法獲取Bean實例,然后調用相應的方法,這種方法避免了直接在非Bean類中注入Bean,保持了代碼的簡潔和可維護性,通過這種方式,可以在不改變原有代碼結構的情況下,實現Bean方法的調用
2025-02-02
idea如何關閉右側類顯示方法
這篇文章主要介紹了idea如何關閉右側類顯示方法，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教
2023-07-07
Java?IO流與NIO技術綜合應用詳細實例代碼
這篇文章主要給大家介紹了關于Java?IO流與NIO技術綜合應用的相關資料,文中包括了字節(jié)流和字符流,以及它們的高級特性如緩沖區(qū)、序列化和反序列化,同時還介紹了NIO中的通道和緩沖區(qū),以及選擇器的使用,需要的朋友可以參考下
2024-12-12
java如何使用jdbc連接TDSQL數據庫
TDSQL是騰訊打造的一款分布式數據庫產品,具備強一致高可用、全球部署架構、分布式水平擴展、高性能、企業(yè)級安全等特性,本文我們就來看看Java如何使用jdbc連接TDSQL數據庫吧
2025-06-06
詳解Java的按位操作符
Java的位操作符用來操作整數基本數據類型中的單個“比特”(bit)，即代進制位。下面通過本文給大家分享Java的按位操作符，感興趣的朋友一起看看吧
2017-09-09