听说你还在使用 BeanUtils 来 copy 属性?来试试这个吧
在《阿里巴巴 Java 开发规范》手册最后一节的应用分层中推荐了应用系统的分层结构。
我比较赞同这种分层结构,这种分层结构带来了诸多好处,但是有一个麻烦之处就是分层领域模型,也就是我们所说的各种 O,比如 DTO、POJO、DO、VO 等等,这样就导致我们项目中存在各种属性相同的 xxO,对于有些工作经验的小伙伴们来说知道使用 BeanUtils 来实现属性复制,但是对于工作经验不是很多的小伙伴可能就是各种 set 和 get 了。这是非常尴尬的一件事。
Spring 的 BeanUtils 虽然可以满足我们大部分的需要,但是只能赋值属性名相同且类型一致的两个属性,比如 VO 里面的 beginTime 是 String 类型的,而 BO 里面的 beginTime 是 Date 类型就无法赋值了。怎么解决这种问题呢?使用 Orika。
Orika 它简化了不同层对象之间映射过程。使用字节码生成器创建开销最小的快速映射,比其他基于反射方式实现(如,Dozer)更快。
简单示例
-
先定义两个需要转换的 VO 和 BO
public class UserVO {
private String userName;
private Integer userAge;
}
public class UserBO {
private String userName;
private Integer userAge;
}
-
测试
Orika 的基础类是 MapperFactory,其用于配置映射并获得用于执行映射工作的 MapperFacade 实例,如下:
MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();
我们将 UserVO 当做源数据,将 UserBO 当做目标数据,如下:
public static void main(String[] args){
MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();
mapperFactory.classMap(UserVO.class,UserBO.class);
MapperFacade mapperFacade = mapperFactory.getMapperFacade();
UserVO userVO = new UserVO("chenssy",18);
UserBO userBO = mapperFacade.map(userVO,UserBO.class);
System.out.println("userName:" + userBO.getUserName() + " --- userAge:" + userBO.getUserAge() );
}
运行结果:
userName:chenssy --- userAge:18
这只是一个比较简单的示例,到这里,可能有小伙伴说:使用 Spring 的 BeanUtils 也可以实现,而且代码量更加少,更加简单,那下面小编就演示他的高级功能,看 Spring BeantUtils 是否还能够实现。
使用
使用 Orika 需要添加 maven 映射:
<dependency>
<groupId>ma.glasnost.orika</groupId>
<artifactId>orika-core</artifactId>
<version>1.4.6</version>
</dependency>
字段不相同映射
上面的示例源对象和目标对象两者的属性都一致,如果两者的属性不一致该如何处理呢?如下:
public class UserVO {
private String userName;
private Integer userAge;
}
public class UserBO {
private String name;
private Integer userAge;
}
我们需要将 userName 的值赋值给 name,userAge 的值赋值给 age,字段映射如下:
public static void main(String[] args){
MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();
mapperFactory.classMap(UserVO.class, UserBO.class)
.field("userName","name")
.field("userAge","userAge").register();
MapperFacade mapperFacade = mapperFactory.getMapperFacade();
UserVO userVO = new UserVO("chenssy-2",19);
UserBO userBO = mapperFacade.map(userVO,UserBO.class);
System.out.println("userName:" + userBO.getName() + " --- userAge:" + userBO.getUserAge() );
}
运行结果如下:
userName:chenssy-2 --- userAge:19
在这里需要注意的是:在进行字段映射时不能忘记调用 register()
方法,它是为了给 MapperFactory 注册配置信息的。
如果按照上面的使用方法,则需要在注册属性映射时要注册所有的属性,哪怕只有一个属性不一致也要注册所有字段映射,包括相同的字段。这种方式会让人崩溃的,比如有 20 个属性只要 1 个不同,难道也需要配置其余 19 个相同的属性?当然不,我们可以通过设置缺省映射配置,这样就无效显示定义映射的。如下:
mapperFactory.classMap(UserVO.class, UserBO.class)
.field("userName","name")
.byDefault().register();
一样可以得到上面相同的运行结果。
排除字段
在我们实际工作中,对于一个 DO 赋值,我们可能只需要其中某一些字段,对于其他的字段我们需要排除掉,这个时候,我们就可以使用 exclude()
不希望该字段参与映射。比如上面实例的 userAge。如下:
mapperFactory.classMap(UserVO.class, UserBO.class)
.field("userName","name")
.exclude("userAge")
.byDefault().register();
运行结果如下:
userName:chenssy-2 --- userAge:null
集合映射
List 集合
将 UserVO 集合数据拷贝到 UserBO 集合中。一般这种情况在我们实际工作中是非常多见的。
不多说,直接上代码。
public static void main(String[] args){
MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();
MapperFacade mapperFacade = mapperFactory.getMapperFacade();
mapperFactory.classMap(UserVO.class,UserBO.class);
List<UserVO> userList = new ArrayList<>();
userList.add(new UserVO("chenssy_1",18));
userList.add(new UserVO("chenssy_2",19));
userList.add(new UserVO("chenssy_3",20));
//进行集合复制
List<UserBO> userBoList = mapperFacade.mapAsList(userList,UserBO.class);
for(UserBO userBO : userBoList){
System.out.println("userName:" + userBO.getUserName() + " --- userAge:" + userBO.getUserAge() );
}
}
运行结果:
userName:chenssy_1 --- userAge:18
userName:chenssy_2 --- userAge:19
userName:chenssy_3 --- userAge:20
其实代码与简单示例中的代码没什么区别,仅仅只是将 map()
方法替换成了 mapAsList()
方法,至于 Map、Set,则 Orika 都提供了相应的方法可以进行映射,这里就不多介绍了。
VO 中有集合
我们可能会遇到这样一种情况,那就是 VO 中包含着一个或者多个集合属性,我们需要将他们的值拷贝到另一个 BO 中的集合属性中。如下:
public class UserBOList {
private List<UserBO> list;
}
public class UserVOList {
private List<UserVO> list;
}
UserBOList 和 UserVOList 中包含一个 List,分别是 UserBO 和 UserVO 的集合。
public static void main(String[] args){
MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();
// 注意这里是 List 的集合中的对象数据
mapperFactory.classMap(UserVO.class,UserBO.class)
.field("userName","name")
.field("userAge","userAge")
.byDefault()
.register();
List<UserVO> list = new ArrayList<>();
list.add(new UserVO("chenssy_11",118));
list.add(new UserVO("chenssy_22",228));
list.add(new UserVO("chenssy_33",338));
UserVOList userVOList = new UserVOList();
userVOList.setList(list);
UserBOList userBOList = mapperFactory.getMapperFacade().map(userVOList,UserBOList.class);
for(UserBO userBO : userBOList.getList()){
System.out.println("userName:" + userBO.getName() + " --- userAge:" + userBO.getUserAge() );
}
}
运行结果:
userName:chenssy_11 --- userAge:118
userName:chenssy_22 --- userAge:228
userName:chenssy_33 --- userAge:338
Map 转换
Map 转换 Bean 是非常常见的常见,下面就演示下,如何利用 Orika 完成 Map 到 Bean 的转换过程。
public static void main(String[] args){
Map<String,Object> map = new HashMap<>();
map.put("userName","chenssy1");
map.put("userAge",18);
MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();
mapperFactory.classMap(HashMap.class, UserBO.class)
.field("userName","userName")
.field("userAge","userAge")
.byDefault()
.register();
UserBO userBO = mapperFactory.getMapperFacade().map(map,UserBO.class);
System.out.println("userName:" + userBO.getUserName() + " --- userAge:" + userBO.getUserAge() );
}
就是如此的简单。
嵌套字段映射
加入在源数据对象中,有另外一个 DTO 需要保持我们映射的值。
这种场景还是挺多见的,不多说,直接看代码。
public class Person {
private UserVO userVO;
}
Person 中包含 UserVO 实例。那如何将其映射到目标对象中呢?为了访问嵌套 DTO 的属性并映射到目标对象,我们只需要使用 . 即可,如下:
public static void main(String[] args){
MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();
mapperFactory.classMap(Person.class, UserBO.class)
.field("userVO.userName","name")
.field("userVO.userAge","userAge")
.register();
UserVO userVO = new UserVO("chenssy",18);
Person person = new Person(userVO);
UserBO userBO = mapperFactory.getMapperFacade().map(person,UserBO.class);
System.out.println("userName:" + userBO.getName() + " --- userAge:" + userBO.getUserAge() );
}
运行结果:
userName:chenssy --- userAge:18
Bean 映射工具选择
以下内容摘自:https://www.jianshu.com/p/40e0e64797b9
-
BeanUtils
Apache的BeanUtils和spring的BeanUtils中拷贝方法的原理都是先用jdk中 java.beans.Introspector
类的getBeanInfo()
方法获取对象的属性信息及属性get/set
方法,接着使用反射(Method的invoke(Object obj, Object... args)
)方法进行赋值。Apache支持名称相同但类型不同的属性的转换,spring支持忽略某些属性不进行映射,他们都设置了缓存保存已解析过的BeanInfo信息。
-
BeanCopier
cglib的BeanCopier采用了不同的方法:它不是利用反射对属性进行赋值,而是直接使用ASM的MethodVisitor直接编写各属性的get/set方法(具体过程可见BeanCopier类的generateClass(ClassVisitor v)
方法)生成class文件,然后进行执行。由于是直接生成字节码执行,所以BeanCopier的性能较采用反射的BeanUtils有较大提高,这一点可在后面的测试中看出。
-
Dozer
使用以上类库虽然可以不用手动编写get/set方法,但是他们都不能对不同名称的对象属性进行映射。在定制化的属性映射方面做得比较好的有Dozer,Dozer支持简单属性映射、复杂类型映射、双向映射、隐式映射以及递归映射。可使用xml或者注解进行映射的配置,支持自动类型转换,使用方便。但Dozer底层是使用reflect包下Field类的set(Object obj, Object value)
方法进行属性赋值,执行速度上不是那么理想。
-
Orika
那么有没有特性丰富,速度又快的Bean映射工具呢.,Orika是近期在github活跃的项目,底层采用了javassist类库生成Bean映射的字节码,之后直接加载执行生成的字节码文件,因此在速度上比使用反射进行赋值会快很多。