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