大家知道，MapStruct是一個(gè)用于生成類型安全，高性能和無依賴的bean映射代碼的注釋處理器。雖然它提高了一個(gè)一個(gè)字段進(jìn)行set賦值的開發(fā)效率，但是版本升級也可能有不兼容的問題。

問題：

1..升級mapstruct到1.3.0版本之后，當(dāng)target類使用lombok的@Builder注解，并且source類和target類的首字母不同的字段沒有被正確轉(zhuǎn)換（1.2.0版本可以正常轉(zhuǎn)換）。

2.升級mapstruct到1.3.0版本之后，當(dāng)target類使用lombok的@Builder注解，并且需要映射到父類的屬性，則編譯時(shí)會報(bào)  Unknown property

分析：

MapStruct 和lombok 的相遇，如果版本不一致，就會帶來一定的問題。

MapStruct是一個(gè)用于生成類型安全，高性能和無依賴的bean映射代碼的注釋處理器；

而LombokLombok是一款Java開發(fā)插件，使得Java開發(fā)者可以通過其定義的一些注解來消除業(yè)務(wù)工程中冗長和繁瑣的代碼，比如get set等，尤其對于簡單的Java模型對象（POJO）。

兩者都是通過注解處理器在編譯期生成對應(yīng)的代碼。

舉例如下：

下圖為基于Lombok注解的POJO類：

這個(gè)是基于MapStruct注解定義的mapper接口

經(jīng)過lombok的注解處理器，編譯后的class如下：

經(jīng)過mapstruct的注解處理器，對UserDTOMapper自動生成了接口實(shí)現(xiàn)類：

結(jié)論：

可見，mapstruct 的注解處理器必須晚于 lombok的注解處理器執(zhí)行，才能保證bean 屬性能被正確映射。而出現(xiàn)上述問題的原因就在于lombok 和 mapstruct的執(zhí)行順序被打亂了。

解決方案：

 在編譯插件中控制注解處理器的順序。

pom 如下：

       <plugin> 
          <groupId>org.apache.maven.plugins</groupId>  
          <artifactId>maven-compiler-plugin</artifactId>  
          <version>${maven-compiler-plugin.version}</version>  
          <configuration> 
            <source>${java.version}</source>  
            <target>${java.version}</target>
<!--            <release>${java.version}</release>-->
            <annotationProcessorPaths> 
              <path> 
                <groupId>org.projectlombok</groupId>  
                <artifactId>lombok</artifactId>  
                <version>${lombok-plugin.version}</version> 
              </path>  
              <path> 
                <groupId>org.mapstruct</groupId>  
                <artifactId>mapstruct-processor</artifactId>  
                <version>${mapstruct-plugin.version}</version> 
              </path>  
              <path> 
                <groupId>org.projectlombok</groupId>  
                <artifactId>lombok-mapstruct-binding</artifactId>  
                <version>${lombok-mapstruct-binding-plugin.version}</version> 
              </path> 
            </annotationProcessorPaths> 
          </configuration> 
        </plugin>

其中 lombok-mapstruct-binding 的包正是為了協(xié)調(diào)lombok和mapstruct的處理過程的。

這里仍然有個(gè)細(xì)節(jié)大家可以關(guān)注下：

（1）在annotationProcessorPaths 中去掉lombok-mapstruct-binding  這個(gè)包，其實(shí)也可以正確執(zhí)行的。只要lombok的path 聲明在 mapstruct之前。

（2）上述的annotationProcessorPaths配置，如果顛倒了lombok和mapstruct的順序，其實(shí)也是可以正確執(zhí)行的，只要同時(shí)引入了lombok-mapstruct-binding 

總結(jié)

1.在POM中沒有annotationProcessorPaths時(shí)，Maven使用的classPath作為注解處理器執(zhí)行的順序，而classPath的順序正是dependencies中匯入的順序。

2.當(dāng)MapStruct依賴在Lombok依賴前面時(shí)，在執(zhí)行注解處理器期間， 由于Lombok還未生成get、set程式碼，因此在MapStruct看來，這些類并沒有公開的成員變數(shù)，也就無從生成用于轉(zhuǎn)換的方法。

3.在使用annotationProcessorPaths后，其強(qiáng)制規(guī)定了注解處理器的順序，dependencies中的順序就被忽略了，Maven一定會先執(zhí)行Lombok再執(zhí)行MapStruct。

到此這篇關(guān)于MapStruct升級遇到的問題及解決方案的文章就介紹到這了,更多相關(guān)MapStruct升級內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論