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 的方式。
开源地址
这个框架的源代码全部开源，也便于我们学习。