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,并验证结果符合我们的预期。
/*** 基础测试*/@Testpublic 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