基於 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