MapStruct到底是什么?
一、簡介
現(xiàn)在的分布式系統(tǒng)中模塊劃分越來越細(xì)，不同模塊的實體、DTO、DO等需要進(jìn)行轉(zhuǎn)換，這么多工程處理起來不是那么簡單。
MapStruct 就是這樣的一個屬性映射插件，用于為Java Bean生成類型安全且高性能的映射。它基于編譯階段生成get/set代碼，此實現(xiàn)過程中沒有反射，不會造成額外的性能損失。只需要定義一個 Mapper 接口，MapStruct 就會自動實現(xiàn)這個映射接口，避免了繁瑣的映射實現(xiàn)。
優(yōu)點
與手工編寫映射代碼相比
- MapStruct通過生成冗長且容易出錯的代碼來節(jié)省時間。
與動態(tài)映射框架相比
- 簡單泛型智能轉(zhuǎn)換；
- 效率高：無需手動 set/get 或 implements Serializable 以達(dá)到深拷貝；
- 性能更高：使用簡單的 Java 方法調(diào)用代替反射；
- 編譯時類型安全：只能映射相同名稱或帶映射標(biāo)記的屬性；
- 編譯時產(chǎn)生錯誤報告：如果映射不完整（存在未被映射的目標(biāo)屬性）或映射不正確（找不到合適的映射方法或類型轉(zhuǎn)換）則會在編譯時拋出異常。
二、Demo
2.1 導(dǎo)入依賴
使用該插件主要需要導(dǎo)入兩個包：
::: details Maven | Gradle
Maven
<dependency>
<groupId>org.mapstruct</groupId>
<!-- jdk8以下就使用mapstruct -->
<artifactId>mapstruct-jdk8</artifactId>
<version>1.3.0.Final</version>
</dependency>
<!-- 注解處理器 -->
<dependency>
<groupId>org.mapstruct</groupId>
<artifactId>mapstruct-processor</artifactId>
<version>1.3.0.Final</version>
</dependency>
Gradle
plugins {
...
id "com.diffplug.eclipse.apt" version "3.26.0" // Only for Eclipse
}
dependencies {
...
compile 'org.mapstruct:mapstruct:1.4.2.Final'
annotationProcessor 'org.mapstruct:mapstruct-processor:1.4.2.Final'
testAnnotationProcessor 'org.mapstruct:mapstruct-processor:1.4.2.Final' // if you are using mapstruct in test code
}
...
2.2 示例代碼
::: details domain、vo、mapper、controller
domain/Person.java
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class Person {
private Long id;
private String name;
private Integer age;
private Integer sex;
}
vo/PersonVO.java
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class PersonVO {
private Long personId;
private String personName;
private Integer age;
}
mapper/PersonMapper.java
@Mapper(componentModel = "spring")
public interface PersonMapper {
/**
* ClassLoader 的方式獲取當(dāng)前 mapper （可以不用）
*/
PersonMapper INSTANCE = Mappers.getMapper(PersonMapper.class);
/**
* 實體轉(zhuǎn)VO
* source
* @param person
* @return PersonVO
*/
@Mappings({
@Mapping(source = "id", target = "personId"),
@Mapping(source = "name", target = "personName")
})
PersonVO toPersonVO(Person person);
/**
* VO轉(zhuǎn)實體
*
* @param person
* @return PersonVO
*/
@Mappings({
@Mapping(source = "personId", target = "id"),
@Mapping(source = "personName", target = "name"),
@Mapping(target = "sex", ignore = true),
})
Person toPerson(PersonVO person);
}
Controller
@RestController
@RequestMapping("/api")
public class TestMapStructController {
@Autowired
PersonMapper personMapper;
@GetMapping("convert")
public List<Object> convertEntity() {
ArrayList<Object> objectList = new ArrayList<>();
Person person = Person.builder()
.id(5L)
.name("zhangsan")
.age(12)
.sex(1)
.build();
objectList.add(person);
PersonVO personVO = personMapper.toPersonVO(person);
Person person1 = personMapper.toPerson(personVO);
objectList.add("person 轉(zhuǎn) personVO" + personVO);
objectList.add("personVO 轉(zhuǎn) person" + person1);
return objectList;
}
}
打包后會看見 mapstruct 為我們生成了 mapper 的實現(xiàn)類
三、 注解介紹
@Mapper ：MapStruct 注解處理器會掃描這個注解
先介紹一下 @Mapper 注解的 componentModel 屬性，該屬性用于自動生成的接口實現(xiàn)類的組件類型，這個屬性支持四個值：
1.default : 這是默認(rèn)的情況，mapstruct 不使用任何組件類型, 可以通過Mappers.getMapper(Class)方式獲取自動生成的實例對象。
2.cdi : 生成的映射器是一個應(yīng)用程序范圍的 CDI bean，可以通過 @Inject 檢索
3.spring : 生成的實現(xiàn)類上面會自動添加一個@Component注解，可以通過Spring的 @Autowired方式進(jìn)行注入
4.jsr330 : 生成的實現(xiàn)類上會添加@javax.inject.Named 和@Singleton注解，可以通過 @Inject注解獲取
@Mappings：配置多個@Mapping
@Mapping 屬性映射，若源對象屬性與目標(biāo)對象名字一致，會自動映射對應(yīng)屬性
1.source ：參數(shù)類的屬性
2.target ：要轉(zhuǎn)換的類的屬性
3.ignore ：配合 target 使用，表示改轉(zhuǎn)換類的的屬性不需要映射
4.expression ：配合 target 使用，表示改轉(zhuǎn)換類的的屬性使用指定的表達(dá)式進(jìn)行轉(zhuǎn)換
@Mapping(
target = "someProp",
expression = "java(new TimeAndFormat( s.getTime(), s.getFormat() ))"
)
5.expression ：配合 target 使用，表示改轉(zhuǎn)換類的的屬性使用指定的表達(dá)式進(jìn)行轉(zhuǎn)換
@Mapping(
target = "someProp",
expression = "java(new TimeAndFormat( s.getTime(), s.getFormat() ))"
)
其他請參考源文件或官網(wǎng)，后續(xù)用到再補(bǔ)充
到此這篇關(guān)于MapStruct到底是什么?的文章就介紹到這了,更多相關(guān)MapStruct的使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
這篇文章主要介紹了關(guān)于aop切面 注解、參數(shù)如何獲取，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教。2022-01-01
學(xué)習(xí)Java中的日期和時間處理及Java日歷小程序的編寫
這篇文章主要介紹了學(xué)習(xí)Java中的日期和時間處理及Java日歷小程序的編寫,這個日歷小程序僅用簡單的算法實現(xiàn)沒有用到date類等,但是帶有圖形界面,需要的朋友可以參考下2016-02-02
Filter?過濾器和Interceptor?攔截器是SpringBoot?的?Web?項目開發(fā)中長用到的，本文主要來和大家討論一下?Filter?與?Interceptor?的做法及它們之間的區(qū)別，需要的可以參考下2023-07-07
file.mkdir()、file.mkdirs()和file.createNewFile()的區(qū)別
本文主要介紹了file.mkdir()、file.mkdirs()和file.createNewFile()的區(qū)別，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2023-04-04
Java的ConcurrentHashMap中不能存儲null的原因解析
眾所周知，在Java中Map可以存儲null，而ConcurrentHashMap不能存儲null值，那么為什么呢？今天通過源碼分析給大家詳細(xì)解讀，感興趣的朋友一起看看吧2022-07-07
這篇文章主要介紹了Java項目安全處理方法，URL中參數(shù)顯示,sql拼接問題,需要的朋友可以參考下2017-09-09
springboot整合gateway實現(xiàn)網(wǎng)關(guān)功能的示例代碼
本文主要介紹了springboot整合gateway實現(xiàn)網(wǎng)關(guān)功能的示例代碼，文中通過示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2022-02-02
這篇文章主要介紹了Java源碼解析Integer方法解讀，包括toString方法、toUnsignedString方法、highestOneBit方法等，具有一定的參考價值，感興趣的小伙伴們可以參考一下2016-12-12
Java8中Optional類型和Kotlin中可空類型的使用對比
這篇文章主要給大家介紹了關(guān)于Java8中Optional類型和Kotlin中可空類型的使用對比，文中通過示例代碼給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧。2017-09-09
本篇文章是關(guān)于ava構(gòu)造方法Vector源碼分析系列文章，本文主要介紹了Vector遍歷元素的源碼分析，有需要的朋友可以借鑒參考下，希望可以有所幫助2021-09-09