spring中Mapstruct屬性映射的實(shí)現(xiàn)

更新時(shí)間：2024年12月06日 11:36:29 作者：七禾頁話

本文主要介紹了spring中Mapstruct屬性映射的實(shí)現(xiàn),文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

整合 Mapstruct : 簡化屬性映射

解決問題:當(dāng)一個(gè)對象屬性過多時(shí)，DO轉(zhuǎn)VO需要寫的字段太多了

1. 什么是 MapStruct？

MapStruct 是一個(gè)用于簡化 Java Bean 映射代碼的代碼生成器。它可以自動(dòng)生成在不同 Java 對象之間進(jìn)行映射的代碼，而無需手動(dòng)編寫復(fù)雜的轉(zhuǎn)換邏輯。MapStruct 使得在 Java 應(yīng)用程序中進(jìn)行對象映射變得更加簡單、高效、可維護(hù)。

2. 為什么要使用 MapStruct？

簡化映射過程： 傳統(tǒng)的 Java 對象映射需要編寫大量的重復(fù)、繁瑣的代碼。MapStruct 自動(dòng)生成這些映射代碼，節(jié)省了開發(fā)人員的時(shí)間和精力。
類型安全性： MapStruct 是基于編譯時(shí)的代碼生成，因此提供了類型安全性。在編譯時(shí)，它會(huì)檢查源對象和目標(biāo)對象的類型，避免了運(yùn)行時(shí)的類型錯(cuò)誤。
高性能： 由于 MapStruct 生成的代碼是高度優(yōu)化的，所以性能非常好。相比手動(dòng)編寫的映射代碼，MapStruct 生成的代碼更加高效。
可維護(hù)性： 當(dāng)數(shù)據(jù)模型發(fā)生變化時(shí)，手動(dòng)更新映射代碼可能會(huì)非常麻煩。MapStruct 能夠根據(jù)最新的數(shù)據(jù)模型自動(dòng)生成新的映射代碼，確保映射邏輯與數(shù)據(jù)模型保持同步。
靈活性： MapStruct 提供了豐富的配置選項(xiàng)和擴(kuò)展點(diǎn)，可以滿足各種復(fù)雜映射場景的需求。你可以定制生成的代碼，以適應(yīng)特定的業(yè)務(wù)邏輯。

3. 添加依賴

多模塊中，在父工程模塊的pom.xm下

    <!-- 版本號(hào)統(tǒng)一管理 -->
    <properties>
        // 省略...
        <mapstruct.version>1.5.5.Final</mapstruct.version>
    </properties>
    
    <!-- 統(tǒng)一依賴管理 -->
    <dependencyManagement>
        <dependencies>
			// 省略...

            <!-- Mapstruct 屬性映射 -->
            <dependency>
                <groupId>org.mapstruct</groupId>
                <artifactId>mapstruct</artifactId>
                <version>${mapstruct.version}</version>
            </dependency>

        </dependencies>
    </dependencyManagement>
    
       <build>
        <!-- 統(tǒng)一插件管理 -->
        <pluginManagement>
            <plugins>
				// 省略...

                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <configuration>
                        <source>${java.version}</source> <!-- 根據(jù)你的 JDK 版本進(jìn)行調(diào)整 -->
                        <target>${java.version}</target> <!-- 根據(jù)你的 JDK 版本進(jìn)行調(diào)整 -->
                        <annotationProcessorPaths>
                            <path>
                                <groupId>org.projectlombok</groupId>
                                <artifactId>lombok</artifactId>
                                <version>${lombok.version}</version>
                            </path>
                            <path>
                                <groupId>org.mapstruct</groupId>
                                <artifactId>mapstruct-processor</artifactId>
                                <version>${mapstruct.version}</version> <!-- 使用時(shí)請檢查最新版本 -->
                            </path>
                        </annotationProcessorPaths>
                    </configuration>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>

在需要使用的模塊中添加

		<dependency>
			<groupId>org.mapstruct</groupId>
			<artifactId>mapstruct</artifactId>
		</dependency>

在入口模塊添加編譯插件:

    <build>
        <plugins>
			// 省略...
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

4. IDEA 配置 Mapstruct

添加好了 MapStruct 依賴后，已經(jīng)可以確保項(xiàng)目中能夠正常使用 MapStruct 了。但是，為了在開發(fā)過程中獲得更好的體驗(yàn)，我們可以為 IDE 進(jìn)行一些配置，從而支持 MapStruct 的自動(dòng)代碼生成、代碼提示等功能。

4.1 啟用注解處理器

打開 IntelliJ IDEA，并加載你的項(xiàng)目。
打開 File -> Settings (或 Preferences)。
在左側(cè)導(dǎo)航欄中選擇 Build, Execution, Deployment -> Compiler -> Annotation Processors。
勾選 Enable annotation processing。
在 Store generated sources relative to 下拉列表中選擇 Module content root。
點(diǎn)擊右下角 Apply 按鈕應(yīng)用設(shè)置，然后，點(diǎn)擊 ok 按鈕關(guān)閉彈框。

在這里插入圖片描述

4.2添加MapStruct插件

雖然這不是必需的，但 MapStruct 插件可以為你提供一些很有用的功能，例如代碼提示和自動(dòng)補(bǔ)全。

打開 File -> Settings (或 Preferences)。
在左側(cè)選擇 Plugins。
在市場 (Marketplace) 中搜索 “MapStruct” 并安裝它。
重啟 IntelliJ IDEA。

5. 添加 convert 接口

新建一個(gè) /convert 包，并創(chuàng)建一個(gè) BlogSettingsConvert 轉(zhuǎn)換接口，代碼如下：

@Mapper
public interface BlogSettingsConvert {
    /**
     * 初始化 convert 實(shí)例
     */
    BlogSettingsConvert INSTANCE = Mappers.getMapper(BlogSettingsConvert.class);

    /**
     * 將 VO 轉(zhuǎn)化為 DO
     * @param bean
     * @return
     */
    BlogSettingsDO convertVO2DO(UpdateBlogSettingsReqVO bean);

}

注意，接口類上添加的 @Mapper 注解，導(dǎo)入自 org.mapstruct.Mapper, 別搞錯(cuò)了哦。

6. 使用 Mapstruct 來轉(zhuǎn)換

@Service
public class AdminBlogSettingsServiceImpl extends ServiceImpl<BlogSettingsMapper, BlogSettingsDO> implements AdminBlogSettingsService {

    @Override
    public Response updateBlogSettings(UpdateBlogSettingsReqVO updateBlogSettingsReqVO) {
        // VO 轉(zhuǎn) DO
        BlogSettingsDO blogSettingsDO = BlogSettingsConvert.INSTANCE.convertVO2DO(updateBlogSettingsReqVO);
        blogSettingsDO.setId(1L);

        // 保存或更新（當(dāng)數(shù)據(jù)庫中存在 ID 為 1 的記錄時(shí)，則執(zhí)行更新操作，否則執(zhí)行插入操作）
        saveOrUpdate(blogSettingsDO);
        return Response.success();
    }
}
ingsDO.setId(1L);

        // 保存或更新（當(dāng)數(shù)據(jù)庫中存在 ID 為 1 的記錄時(shí)，則執(zhí)行更新操作，否則執(zhí)行插入操作）
        saveOrUpdate(blogSettingsDO);
        return Response.success();
    }
}

將 VO 類轉(zhuǎn)換為了 DO 類，僅需要對 VO 中沒有值的字段，如 ID 字段設(shè)置一下值即可

到此這篇關(guān)于spring中Mapstruct屬性映射的實(shí)現(xiàn)的文章就介紹到這了,更多相關(guān)spring Mapstruct屬性映射內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: