日常开发中经常需要将一个对象的属性,赋值到另一个对象中。
常见的工具有很多,但都多少不够简洁,要么不够强大。
我们经常使用的 Spring BeanUtils 性能较好,但是特性不足。
Bean-Mapping 提供了很多丰富的特性,便于日常开发。
如果你追求更加极致的性能,可以考虑使用 asm 实现的模块,该实现性能优于 spring BeanUtils 35% 左右。
JDK1.7 及其以上版本
Maven 3.X 及其以上版本
<dependency> <groupId>com.github.houbb</groupId> <artifactId>bean-mapping-core</artifactId> <version>0.2.5</version> </dependency>
提供一个简单的静态方法 copyProperties。
/** * 复制属性 * 将 source 中的赋值给 target 中名称相同,且可以赋值的类型中去。类似于 spring 的 BeanUtils。 * @param source 原始对象 * @param target 目标对象 */ public static void copyProperties(final Object source, Object target)
详情参见 bean-mapping-test 模块下的测试代码。
其中 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 的复制方式,性能比 spring 好 35% 左右。
见文末的 benchmark。
<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