Java bean常见映射工具分析和比较

1. 概述

日常Java开发项目中，我们经常需要将对象转换成其他形式的对象，因此我们需要编写映射代码将对象中的属性值从一种类型转换成另一种类型。

进行这种转换除了手动编写大量的get/set代码，还可以使用一些方便的类库：

apache的BeanUtils

spring的BeanUtils

cglib的BeanCopier。

2.比较

2.1 BeanUtils

BeanUtils一套开发包，Apache公司提供 ，专门进行javabean操作，在web层各种框架中被使用，例如：struts 使用BeanUtils操作JavaBean 。

实例
1、下载BeanUtils的jar ：commons-beanutils 、commons-logging，需要同时下载两个jar包。（BeanUtils依赖Logging的jar包 ）
2、将beanutils和logging的 jar包复制 工程/WebContent/WEB-INF/lib

apache的BeanUtils和spring的BeanUtils中拷贝方法的原理都是先用jdk中 java.beans.Introspector类的getBeanInfo()方法获取对象的属性信息及属性get/set方法，接着使用反射（Method的invoke(Object obj, Object... args)）方法进行赋值。apache支持名称相同但类型不同的属性的转换，spring支持忽略某些属性不进行映射，他们都设置了缓存保存已解析过的BeanInfo信息。

commons.beanutils-1.8.3.jar

spring.beans-4.2.3.RELEASE.jar

<dependency>
  <groupId>commons-beanutils</groupId>
  <artifactId>commons-beanutils</artifactId>
  <version>1.9.3</version>
</dependency>

import org.apache.commons.beanutils.BeanUtils;

public class TestBeanUtils extends HttpServlet {
      @Override
      protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
      //1.设置编码
      req.setCharacterEncoding("utf-8");
     //2.获取数据
      Map<String, String[]> params = req.getParameterMap();
     //System.out.println(params);
      //3.使用BeanUtils工具类封装User对象
       Users user = new Users();
try {
      BeanUtils.populate(user, params);
} catch (IllegalAccessException e) {
     e.printStackTrace();
} catch (InvocationTargetException e) {
     e.printStackTrace();
}
System.out.println(user);

}

@Override
     protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
           this.doPost(req, resp);
     }
}

2.2 BeanCopier

cglib的BeanCopier采用了不同的方法：它不是利用反射对属性进行赋值，而是直接使用ASM的MethodVisitor直接编写各属性的get/set方法（具体过程可见BeanCopier类的generateClass(ClassVisitor v)方法）生成class文件，然后进行执行。由于是直接生成字节码执行，所以BeanCopier的性能较采用反射的BeanUtils有较大提高，这一点可在后面的测试中看出。

2.3 Dozer

使用以上类库虽然可以不用手动编写get/set方法，但是他们都不能对不同名称的对象属性进行映射。在定制化的属性映射方面做得比较好的有Dozer，Dozer支持简单属性映射、复杂类型映射、双向映射、隐式映射以及递归映射。可使用xml或者注解进行映射的配置，支持自动类型转换，使用方便。但Dozer底层是使用reflect包下Field类的set(Object obj, Object value)方法进行属性赋值，执行速度上不是那么理想。

2.4 Orika

那么有没有特性丰富，速度又快的Bean映射工具呢，这就是下面要介绍的Orika，Orika是近期在github活跃的项目，底层采用了javassist类库生成Bean映射的字节码，之后直接加载执行生成的字节码文件，因此在速度上比使用反射进行赋值会快很多，下面详细介绍Orika的使用方法。

3. Orika使用

依赖

<dependency>
    <groupId>ma.glasnost.orika</groupId>
    <artifactId>orika-core</artifactId>
    <version>1.5.2</version><!-- or latest version -->
</dependency>  

简单映射

1. 构造一个MapperFactory

MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();  

1. 注册字段映射

mapperFactory.classMap(PersonSource.class, PersonDestination.class)
   .field("firstName", "givenName")
   .field("lastName", "sirName")
   .byDefault()
   .register();

1. 进行映射

MapperFacade mapper = mapperFactory.getMapperFacade();

PersonSource source = new PersonSource();
// set some field values
...
// map the fields of 'source' onto a new instance of PersonDest
PersonDest destination = mapper.map(source, PersonDest.class);  

在第二步进行的字段映射是双向的，我们可以从目标类型映射回源类型，byDefault()方法用于注册名称相同的属性（如果所有属性名称都相同则可以省略第2步），如果不希望某个字段参与映射，可以使用exclude方法

复杂映射

数组和List的映射

如果在目标类和目的类中分别有下面的属性

class BasicPerson {
  private List<String> nameParts;
  // getters/setters omitted
}
class BasicPersonDto {
  private String firstName;
  private String lastName;
  // getters/setters omitted
}

可以使用下面的方式进行映射：

mapperFactory.classMap(BasicPerson.class, BasicPersonDto.class)
   .field("nameParts[0]", "firstName")
   .field("nameParts[1]", "lastName")
   .register();

类类型的映射

class Name {
   private String first;
   private String last;
   private String fullName;
   // getters/setters
}

class BasicPerson {
  private Name name;
  // getters/setters omitted
}
class BasicPersonDto {
  private String firstName;
  // getters/setters omitted
}

使用：

mapperFactory.classMap(BasicPerson.class, BasicPersonDto.class)
   .field("name.first", "firstName")
   .register();

自定义转换器

orika同样支持自定义转换器，将指定类型或指定名称的属性做映射时添加自定义操作，例如，将String类型的或某个属性映射后加一个前缀，或者将Integer类型映射后加1等：

public class MyConverter extends CustomConverter<Date,MyDate> {
   public MyDate convert(Date source, Type<? extends MyDate> destinationType) {
      // return a new instance of destinationType with all properties filled
      //example：source + 1；
   }
}

Date为源类型中要做转换的属性数据类型，例如String、Integer等，MyDate为目标类型中要做转换的属性数据类型。

如果需要定义全局范围的转换：

ConverterFactory converterFactory = mapperFactory.getConverterFactory();
converterFactory.registerConverter(new MyConverter());  

如果仅需要某几个属性使用转换器：

ConverterFactory converterFactory = mapperFactory.getConverterFactory();
converterFactory.registerConverter("myConverterIdValue", new MyConverter());

mapperFactory.classMap( Source.class, Destination.class )
   .fieldMap("sourceField1", "sourceField2").converter("myConverterIdValue").add()
   ...
   .register();

其他说明

1. Orika支持递归映射，将映射嵌套类直到用“简单”类型完成映射。它还包含故障保险，以正确处理正在尝试映射的对象中的递归引用。

2. 在于spring集成时，可以将MapperFactory设置为单例

各映射工具的性能测试

构造一个包含普通类型及类类型的Bean对象,使用jmh微基准框架进行测试。由于jvm会对热点代码进行优化：方法反射调用次数超过阈值时会生成一个专用的MethodAccessor实现类，生成其中的invoke()方法的字节码进行执行。

故测试时每种方法先预热执行15次，而后再执行100次获取每次执行的平均时间：

Benchmark                     Mode  Samples   Score  Score error  Units
o.s.MyBenchmark.apache        avgt      100  25.246        0.535  us/op
o.s.MyBenchmark.beanCopier    avgt      100   0.004        0.000  us/op
o.s.MyBenchmark.byHand        avgt      100   0.004        0.000  us/op
o.s.MyBenchmark.dozer         avgt      100   5.855        0.260  us/op
o.s.MyBenchmark.orika         avgt      100   0.353        0.017  us/op
o.s.MyBenchmark.spring        avgt      100   0.627        0.020  us/op  

统计报告中Units单位为微秒/次，由Score项可以看出，基于ASM的cglib BeanCopier拷贝速度基本和手写get/set方法的速度无异，其次的就是基于javassist的Orika了，Orika的速度是spring BeanUtils的两倍，Dozer的20倍，Apache BeanUtils的120倍。

综上，当属性名和属性类型完全相同时使用BeanCopier是最好的选择，当存在属性名称不同或者属性名称相同但属性类型不同的情况时，使用Orika是一种不错的选择。如果你对Orika感到不放心，实际应用前可以写个测试类查看它的转换结果是否符合预期。