java中常见的对象转换工具

前言

我们在写搬砖的过程中，少不了需要将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的使用体验。

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条数据下的测试情况：

10条数据下的测试情况：

100条数据下的测试情况：

1000条数据下的测试情况：

10000条数据下的测试情况:

	mapstruct	Spring BeanUtils	Apache BeanUtils
1	2ms	198ms	53ms
10	2ms	326ms	199ms
100	3ms	277ms	1236ms
1000	4ms	636ms	5320ms
10000	15ms	629ms	39843ms

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

• mapstruct 表现稳定，性能最高，这和它的实现方式有关。

• Spring BeanUtils 次之，性能也比较稳定，但是小数据量下性能不显著。

• Apache BeanUtils 最差，性能随着数据量的增长而快速增长。在大数据量下千万别用。

总结

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