欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

性能爆棚的實體轉(zhuǎn)換復(fù)制工具M(jìn)apStruct使用詳解

 更新時間：2023年03月27日 14:34:40   作者：紅兔哥  
這篇文章主要為大家介紹了性能爆棚的實體轉(zhuǎn)換復(fù)制工具M(jìn)apStruct使用詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪

引言

Java項目中實體轉(zhuǎn)換無處不在，當(dāng)實體字段較多或者大批量的進(jìn)行復(fù)制時，通過手工setter/getter顯得太LOW，同時兼?zhèn)涓咝阅芤笄闆r下，MapStruct完全完全能夠勝任。官方解釋，MapStruct是一個代碼生成器，它基于約定優(yōu)于配置的方法，極大地簡化了Java bean類型之間映射的實現(xiàn)。生成的映射代碼使用普通方法調(diào)用，因此快速、類型安全且易于理解。因為MapStruct是在編譯期間生成setter/getter方法，實際運行時就是直接調(diào)用setter/getter，效率會非常高。

優(yōu)點

  • MapStruct編譯期生成映射代碼，所以可以在編譯時暴露映射錯誤的代碼，讓錯誤提前暴露；
  • 因為使用setter/getter方式，而非反射方式，所以可以更快的執(zhí)行效率；
  • 可以實現(xiàn)深拷貝，自動類型轉(zhuǎn)換，如枚舉轉(zhuǎn)換；
  • 進(jìn)行自定義的映射，多種映射方式，下邊具體說明；

性能對比

對比對象10個對象復(fù)制1次1萬個對象復(fù)制1次100萬個對象復(fù)制1次100萬個對象復(fù)制5次
MapStruct0ms3ms96ms281ms
Hutools的BeanUtil23ms102ms1734ms8316ms
Spring的BeanUtils2ms47ms726ms3676ms
Apache的BeanUtils20ms156ms10658ms52355ms
Apache的PropertyUtils5ms68ms6767ms30694ms

使用

依賴

<!-- MapStruct核心，包含了一些必要的注解-->
<dependencies>
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>${org.mapstruct.version}</version>
    </dependency>
</dependencies>
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <annotationProcessorPaths>
                    <!-- MapStruct編譯，注解處理器，根據(jù)注解自動生成Mapper的實現(xiàn) -->
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>${org.mapstruct.version}</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

定義轉(zhuǎn)換接口

/**
 * 測試接口
 *
 * @author reboot
 */
@Mapper
public interface OrderConvertor {
    /**
     * 實例
     */
    OrderConvertor INSTANCE = Mappers.getMapper(OrderConvertor.class);
    /**
     * OrderDo -> OrderModel
     *
     * @param orderDo 訂單實體
     * @return {@link OrderModel}
     */
    OrderModel toModel(OrderDo orderDo);
    /**
     * OrderDo -> OrderModel
     *
     * @param orderDos 訂單實體
     * @return {@link OrderModel}
     */
    List<OrderModel> toModel(List<OrderDo> orderDos);
    /**
     * OrderModel -> OrderDo
     *
     * @param orderModel 訂單模型
     * @return {@link OrderDo}
     */
    OrderDo toDo(OrderModel orderModel);
    /**
     * OrderModel -> OrderDo
     *
     * @param orderModels 訂單模型
     * @return {@link OrderDo}
     */
    List<OrderDo> toDo(List<OrderModel> orderModels);
}

編譯結(jié)果

MapStruct會自動生成對應(yīng)接口的實現(xiàn)，并自動完成屬性映射關(guān)系，List會自動進(jìn)行批量處理。

調(diào)用

/**
 * 訂單服務(wù)
 *
 * @author reboot
 */
@Service
public class OrderService {
    /**
     * 獲取訂單列表
     *
     * @return {@link List}<{@link OrderModel}>
     */
    public List<OrderModel> getOrderList() {
        // 獲取數(shù)據(jù)庫數(shù)據(jù)DO
        List<OrderDo> result = selectOrderList();
        // 參數(shù)轉(zhuǎn)換
        return OrderConvertor.INSTANCE.toModel(result);
    }
}

插件

上邊的使用方式雖然能夠正常使用，但是在一些屬性配置映射上和提示上，如果使用插件能夠提升使用體驗，IDEA中可以直接安裝Mapstruct Support插件，當(dāng)然Eclipse也有對應(yīng)的插件。

特性

  • 突出顯示目標(biāo)屬性和源屬性。將目標(biāo)屬性和源屬性轉(zhuǎn)到聲明的setter / getter中；
  • 錯誤和快速修復(fù)：
    • 缺少@Mapper或@MapperConfig注解檢查；
    • 快速修復(fù)未映射的目標(biāo)屬性，添加未映射目標(biāo)屬性和忽略未映射目標(biāo)屬性；

其他用法

更加詳細(xì)的內(nèi)容可以查看官方文檔，發(fā)布文章時最新版本是 MapStruct 1.5.3.Final.html。

基礎(chǔ)映射

@Mapper
public interface CarMapper {
    @Mapping(target = "manufacturer", source = "make")
    @Mapping(target = "seatCount", source = "numberOfSeats")
    CarDto carToCarDto(Car car);
    @Mapping(target = "fullName", source = "name")
    PersonDto personToPersonDto(Person person);
}

target表示目標(biāo)屬性名，source表示源屬性名，一般在目標(biāo)屬性和源屬性不同時使用，相同的屬性名會自動進(jìn)行映射。

映射器添加自定義方法

@Mapper
public interface CarMapper {
    @Mapping(...)
    ...
    CarDto carToCarDto(Car car);
    default PersonDto personToPersonDto(Person person) {
        //hand-written mapping logic
    }
}

自定義方法personToPersonDto并實現(xiàn)，在生成的實現(xiàn)類中會進(jìn)行覆蓋使用。

多個源參數(shù)映射

@Mapper
public interface AddressMapper {
    @Mapping(target = "description", source = "person.description")
    @Mapping(target = "houseNumber", source = "address.houseNo")
    DeliveryAddressDto personAndAddressToDeliveryAddressDto(Person person, Address address);
    @Mapping(target = "description", source = "person.description")
    @Mapping(target = "houseNumber", source = "hn")
    DeliveryAddressDto personAndAddressToDeliveryAddressDto(Person person, Integer hn);
}

存在多個源參數(shù)，使用參數(shù)名.屬性名的方式進(jìn)行表示，也可以直接使用基礎(chǔ)類型的屬性名稱。

嵌套屬性映射到當(dāng)前目標(biāo)

@Mapper
 public interface CustomerMapper {
     @Mapping( target = "name", source = "record.name" )
     @Mapping( target = ".", source = "record" )
     @Mapping( target = ".", source = "account" )
     Customer customerDtoToCustomer(CustomerDto customerDto);
 }

當(dāng)源參數(shù)中存在對象屬性，可以手動進(jìn)行映射，或者直接使用"."的方式將對象中的屬性全部映射到當(dāng)前目標(biāo)對象。

表達(dá)式方式

@Mapper
public interface SourceTargetMapper {
    SourceTargetMapper INSTANCE = Mappers.getMapper( SourceTargetMapper.class );
    @Mapping(
        target = "timeAndFormat",
        expression = "java( new org.sample.TimeAndFormat( s.getTime(), s.getFormat() ) )"
    )
    Target sourceToTarget(Source s);
}

支持使用java代碼塊進(jìn)行轉(zhuǎn)換，一般可以將靜態(tài)方法處理的字段放到這里。

更新現(xiàn)有實例

@Mapper
public interface CarMapper {
    void updateCarFromDto(CarDto carDto, @MappingTarget Car car);
}

@MappingTarget源參數(shù)，編譯時會將carDto參數(shù)中的屬性映射到car參數(shù)中。

Map映射

@Mapper
public interface CustomerMapper {
    @Mapping(target = "name", source = "customerName")
    Customer toCustomer(Map<String, String> map);
}

直接將map中的key進(jìn)行映射。

更多用法

還有更多其他用法，比如：

  • 支持映射定義的public屬性；
  • 支持映射參數(shù)Builder模式；
  • 使用注入方式引入轉(zhuǎn)換器；
  • 數(shù)據(jù)類型字段轉(zhuǎn)換，如枚舉、日期，支持日期格式化，支持?jǐn)?shù)字類型格式化，具體可以看 Implicit type conversions；
  • 集合類型自動轉(zhuǎn)換；
  • 轉(zhuǎn)換Stream；
  • ......

總結(jié)

MapStruct還有很多其他高階特性，限于篇幅文章僅僅列舉部分示例，有興趣的同學(xué)可以查看對應(yīng)文檔試試。使用適當(dāng)?shù)墓ぞ哂行岣呔幊绦?，在使用工具過程中我們也了解其實現(xiàn)原理，不斷提高自身。后邊有時間也把MapStruct實現(xiàn)原理拿出來講講，跟大家一起學(xué)習(xí)進(jìn)步！

以上就是性能爆棚的實體轉(zhuǎn)換復(fù)制工具M(jìn)apStruct使用詳解的詳細(xì)內(nèi)容，更多關(guān)于MapStruct實體轉(zhuǎn)換復(fù)制的資料請關(guān)注腳本之家其它相關(guān)文章！

相關(guān)文章

最新評論