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 相關文檔:
07-BeanUtil#copyProperties(Object, Class) 方法
性能
對比圖
可見框架默認 bean-mapping 實現性能一般，涉及到了太多的特性，導致復制性能略低於 spring。
基於 reflectasm 實現的 asm-bean-mapping 的性能高於 spring。
代碼示例參見 BeanUtilBeanchmarkTest.java
展望
相對 BeanCopier 這種實現方式，我們的實現方式性能還是有很大提升空間。
后期可以考慮實現類似 BeanCopier 的方式。
開源地址
這個框架的源代碼全部開源，也便於我們學習。