基於 asm 實現比 spring BeanUtils 性能更好的屬性拷貝框架

Bean-Mapping

平常開發中常常須要將一個對象的屬性，賦值到另外一個對象中。

常見的工具備不少，但都多少不夠簡潔，要麼不夠強大。

咱們常常使用的 Spring BeanUtils 性能較好，可是特性不足。

Bean-Mapping 提供了不少豐富的特性，便於平常開發。

若是你追求更加極致的性能，能夠考慮使用 asm 實現的模塊，該實現性能優於 spring BeanUtils 35% 左右。

特性

• 支持對象屬性的淺拷貝

• 支持不一樣名稱字段的指定賦值

• 支持自定義字段屬性賦值的條件，好比目標字段不爲 null 才進行賦值

• 支持自定義字段值轉換，能夠轉換爲其餘類型，或者相同類型

• 支持屬性字段爲【對象】【集合】【數組】的賦值，對象賦值更加方便。

• 支持基於 asm 實現的高性能複製

快速開始

準備

JDK1.7 及其以上版本

Maven 3.X 及其以上版本

maven 項目依賴

<dependency>
    <groupId>com.github.houbb</groupId>
    <artifactId>bean-mapping-core</artifactId>
    <version>0.2.5</version>
</dependency>

核心類說明

BeanUtil

提供一個簡單的靜態方法 copyProperties。

/**
 * 複製屬性
 * 將 source 中的賦值給 target 中名稱相同，且能夠賦值的類型中去。相似於 spring 的 BeanUtils。
 * @param source 原始對象
 * @param target 目標對象
 */
public static void copyProperties(final Object source, Object target)

測試代碼參考

詳情參見 bean-mapping-test 模塊下的測試代碼。

示例代碼

對象的定義

• BaseSource.java & BaseTarget.java

其中 BaseSource 對象和 BaseTarget 對象的屬性是相同的。

public class BaseSource {

    /**
     * 名稱
     */
    private String name;

    /**
     * 年齡
     */
    private int age;

    /**
     * 生日
     */
    private Date birthday;

    /**
     * 字符串列表
     */
    private List<String> stringList;

    //getter & setter
}

屬性賦值測試案例

咱們構建 BaseSource 的屬性，而後調用

BeanUtil.copyProperties(baseSource, baseTarget);

相似於 spring BeanUtils 和 Apache BeanUtils，並驗證結果符合咱們的預期。

/**
     * 基礎測試
     */
    @Test
    public void baseTest() {
        BaseSource baseSource = buildBaseSource();
        BaseTarget baseTarget = new BaseTarget();
        BeanUtil.copyProperties(baseSource, baseTarget);

        // 斷言賦值後的屬性和原來相同
        Assertions.assertEquals(baseSource.getAge(), baseTarget.getAge());
        Assertions.assertEquals(baseSource.getName(), baseTarget.getName());
        Assertions.assertEquals(baseSource.getBirthday(), baseTarget.getBirthday());
        Assertions.assertEquals(baseSource.getStringList(), baseTarget.getStringList());
    }

    /**
     * 構建用戶信息
     * @return 用戶
     */
    private BaseSource buildBaseSource() {
        BaseSource baseSource = new BaseSource();
        baseSource.setAge(10);
        baseSource.setName("映射測試");
        baseSource.setBirthday(new Date());
        baseSource.setStringList(Arrays.asList("1", "2"));
        return baseSource;
    }

asm 複製

簡介

有時候咱們對於性能要求較高，而對便利性要求沒有這麼高。

本框架也提供了基於 asm 的複製方式，性能比 spring 好 35% 左右。

見文末的 benchmark。

maven 引入

<dependency>
    <groupId>com.github.houbb</groupId>
    <artifactId>bean-mapping-asm</artifactId>
    <version>0.2.5</version>
</dependency>

測試代碼

和 BeanUtil#copyProperties(Object, Object) 使用相似，可是暫時不支持註解等更加豐富的功能。

BaseSource baseSource = buildBaseSource();
BaseTarget baseTarget = new BaseTarget();
AsmBeanUtil.copyProperties(baseSource, baseTarget);

拓展閱讀

實際工做中，咱們遇到的狀況會比這個複雜一些。

好比兩個字段名稱不一樣，咱們也想進行賦值，值得處理轉換等等。

深刻學習

Bean-Mapping 相關文檔:

01-項目模塊簡介和預期功能

02-BeanMapping 註解的引入

03-不一樣名稱字段的指定賦值

04-自定義賦值生效的條件

05-自定義字段轉換實現

06-支持屬性字段爲【對象】【集合】【數組】的賦值

07-BeanUtil#copyProperties(Object, Class) 方法

性能

對比圖

可見框架默認 bean-mapping 實現性能通常，涉及到了太多的特性，致使複製性能略低於 spring。

基於 reflectasm 實現的 asm-bean-mapping 的性能高於 spring。

代碼示例參見 BeanUtilBeanchmarkTest.java

展望

相對 BeanCopier 這種實現方式，咱們的實現方式性能仍是有很大提高空間。

後期能夠考慮實現相似 BeanCopier 的方式。

開源地址

這個框架的源代碼所有開源，也便於咱們學習。

Bean-Mapping