java中常见的对象转换工具

傷城~ 2023-10-08 22:31 15阅读 0赞

## 前言 ##

我们在写搬砖的过程中，少不了需要将A对象转成B对象，对对象进行对象的转换是一个操作重复且繁琐的工作。于是市面上就有许多的对象转换工具来解决这个问题，下面我们就来看看几个比较常用的工具（mapstruct，Spring BeanUtils，Apache BeanUtils）使用方式及其性能 。

## 用法介绍 ##

### mapstruct ###

mapstruct基于注解+字节码生成的方式使用和运行。其支持的功能全面，运行时速度也很快（直接生成转换器类字节码）。示例如下：

#### maven依赖 ####

<dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>1.4.2.Final</version>
    </dependency>
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-jdk8</artifactId>
        <version>1.4.2.Final</version>
    </dependency>
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
        <version>1.4.2.Final</version>
        <scope>provided</scope>
    </dependency>
    复制代码

1.  mapstruct：MapStruct的核心库，包含了MapStruct的基本功能和API。
2.  mapstruct-jdk8：MapStruct的扩展库，包含了对Java 8新特性的支持，例如对LocalDate、LocalTime、LocalDateTime等类型的映射。
3.  mapstruct-processor：MapStruct的注解处理器，用于在编译时生成映射代码。

#### 使用介绍 ####

@Mapper
    public interface UserMapper {
        UserMapper INSTANCE = Mappers.getMapper(UserMapper.class);
    
        @Mapping(source = "name", target = "fullName")
        UserVO toUserVO(User user);
    
        List<UserVO> toUserVOs(List<User> users);
    }
    
    @Data
    public static class UserVO {
        private String fullName;
        private int    age;
    }
    
    @Data
    public static class User {
        private String name;
        private int    age;
    }
    
    // 使用
    UserVO userVO = UserMapper.INSTANCE.toUserVO(new User("", ""));
    List<UserVO> userVOs = UserMapper.INSTANCE.toUserVOs(users);
    复制代码

如示例所示，

1.  我们只需要定义一个转换器接口，并标记注解@Mapper 。
2.  UserMapper INSTANCE 添加一个调用单例对象。
3.  UserVO toUserVO(User user); 书写转换方法，当两者的属性名称不一致时，可以添加@Mapping 注解来配置对应关系。
4.  其也可以支持列表的转换，这可以说是相当的方便了。
5.  查看反编译的源码，可以看到他对null是有检测了，我们也不怕转换的过程中出现空指针异常了。
6.  @Mapping(target = "creationDate", expression = "java(new java.util.Date())") 。我们可以这样，去给一个对象设置默认值。
7.  UserVO toUserVO(User user, Dep dep); 我们还可以将多个对象的值同时拷贝赋值到一个对象中。原理和单对象复制一样。

多源示例代码：

@Mapping(source = "person.description", target = "description")
    @Mapping(source = "address.houseNo", target = "houseNumber")
    DeliveryAddressDto personAndAddressToDeliveryAddressDto(Person person, Address address);
    复制代码

#### 插件工具 ####

我们可以在idea的插件市场搜索 【MapStruct support】插件，可以增强MapStruct的使用体验。

![format_png][]

### Spring BeanUtils ###

Spring BeanUtils使用简单，其有几下几个特点：

1.  支持类型转换：BeanUtils可以自动将源对象属性的类型转换为目标对象属性的类型，例如将字符串类型的属性值转换为整数类型。
2.  支持批量复制：BeanUtils可以同时复制多个JavaBean对象的属性，从而简化复制操作。
3.  支持忽略属性：BeanUtils可以忽略某些属性的复制，从而减少不必要的复制操作。
4.  为了提高性能，spring缓存了PropertyDescriptor，以提高对象转换的速度。
5.  不支持属性名称不一致的拷贝，这一点需要注意下，需要拷贝属性了之后，自行处理一下。

示例代码：

org.springframework.beans.BeanUtils.copyProperties(user, userVO);
    复制代码

### Apache BeanUtils ###

Apache BeanUtils和Spring BeanUtils使用方式差不多，**唯一需要注意的是：Apache BeanUtils的目标类在前面，这一点和Spring BeanUtils正好相反**。其特性和Spring BeanUtils差不多。不同点是：

*  不支持忽略属性配置。
 *  未缓存Class配置，从效率来说，如果复制的对象比较多，效率奇差。从后文的【性能分析】中可以看出。

示例代码：

BeanUtils.copyProperties(userVO, user);
    复制代码

## 性能分析 ##

下面附上mapstruct，Spring BeanUtils，Apache BeanUtils转换对象时时长运行截图：

1条数据下的测试情况：

![format_png 1][]

10条数据下的测试情况：

![format_png 2][]

100条数据下的测试情况：

![format_png 3][]

1000条数据下的测试情况：

![format_png 4][]

10000条数据下的测试情况:

![format_png 5][]

<table> 
 <thead> 
  <tr> 
   <th></th> 
   <th>mapstruct</th> 
   <th>Spring BeanUtils</th> 
   <th>Apache BeanUtils</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1</td> 
   <td>2ms</td> 
   <td>198ms</td> 
   <td>53ms</td> 
  </tr> 
  <tr> 
   <td>10</td> 
   <td>2ms</td> 
   <td>326ms</td> 
   <td>199ms</td> 
  </tr> 
  <tr> 
   <td>100</td> 
   <td>3ms</td> 
   <td>277ms</td> 
   <td>1236ms</td> 
  </tr> 
  <tr> 
   <td>1000</td> 
   <td>4ms</td> 
   <td>636ms</td> 
   <td>5320ms</td> 
  </tr> 
  <tr> 
   <td>10000</td> 
   <td>15ms</td> 
   <td>629ms</td> 
   <td>39843ms</td> 
  </tr> 
 </tbody> 
</table>

从上图中我们可以看出（以上数据仅供参考，更精确的测试可以使用JMH进行）。

*  mapstruct 表现稳定，性能最高，这和它的实现方式有关。
 *  Spring BeanUtils 次之，性能也比较稳定，但是小数据量下性能不显著。
 *  Apache BeanUtils 最差，性能随着数据量的增长而快速增长。在大数据量下千万别用。

## 总结 ##

一般我们简单的属性复制用Spring BeanUtils 就可以了，如果数据量比较大或者属性复制的逻辑关系比较复杂，我们可以用mapstruct完成功能。一般不建议使用Apache BeanUtils。

作者：阿Qoder  
链接：https://juejin.cn/post/7225186082312405048  
来源：稀土掘金  
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

[format_png]: https://img-blog.csdnimg.cn/img_convert/bdc4a9d072abe53d6f998853b69b85dc.webp?x-oss-process=image/format,png
[format_png 1]: https://img-blog.csdnimg.cn/img_convert/b43dc465fe6152f927afe5940b54b4cf.webp?x-oss-process=image/format,png
[format_png 2]: https://img-blog.csdnimg.cn/img_convert/9a0c3080b5687c3326a10b768c05f671.webp?x-oss-process=image/format,png
[format_png 3]: https://img-blog.csdnimg.cn/img_convert/37d4eb5c6b1f5823b4c463304351fee4.webp?x-oss-process=image/format,png
[format_png 4]: https://img-blog.csdnimg.cn/img_convert/9eb991d1d2e292b246b682f6bc5e5411.webp?x-oss-process=image/format,png
[format_png 5]: https://img-blog.csdnimg.cn/img_convert/8d2e847ffe93f11736565ec891524372.webp?x-oss-process=image/format,png