Java中常见的对象转换工具

目录

• 前言
• 用法介绍
• mapstruct
• maven依赖
• 使用介绍
• 插件工具
• Spring BeanUtils
• Apache BeanUtils
• 性能分析
• 总结

前言

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

• mapstruct：MapStruct的核心库，包含了MapStruct的基本功能和API。
• mapstruct-jdk8：MapStruct的扩展库，包含了对Java 8新特性的支持，例如对LocalDate、LocalTime、LocalDateTime等类型的映射。
• 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);

如示例所示，

• 我们只需要定义一个转换器接口，并标记注解@Mapper 。
• UserMapper INSTANCE 添加一个调用单例对象。
• UserVO toUserVO(User user); 书写转换方法，当两者的属性名称不一致时，可以添加@Mapping 注解来配置对应关系。
• 其也可以支持列表的转换，这可以说是相当的方便了。
• 查看反编译的源码，可以看到他对null是有检测了，我们也不怕转换的过程中出现空指针异常了。
• @Mapping(target = "creationDate", expression = "java(new java.util.Date())") 。我们可以这样，去给一个对象设置默认值。
• 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使用简单，其有几下几个特点：

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

示例代码：

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

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

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

总结

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

到此这篇关于Java中常见的对象转换工具的文章就介绍到这了,更多相关Java对象转换工具内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！