微信公众号模板素材网站,wordpress扫码付费可见插件,wordpress图片属性添加图片,网站建设文化流程图在业务项目的开发中#xff0c;我们经常需要将 Java 对象进行转换#xff0c;比如从将外部微服务得到的对象转换为本域的业务对象 domainobject#xff0c;将 domainobject 转为数据持久层的 dataobject#xff0c;将 domainobject 转换为 DTO 以便返回给外部调用方等。在转…在业务项目的开发中我们经常需要将 Java 对象进行转换比如从将外部微服务得到的对象转换为本域的业务对象 domainobject将 domainobject 转为数据持久层的 dataobject将 domainobject 转换为 DTO 以便返回给外部调用方等。在转换时大部分属性都是相同的只有少部分的不同如果手工编写转换代码会很繁琐。这时我们可以通过一些对象转换框架来更方便的做这件事情。这样的对象转换框架有不少比较有名的有 ModelMapper 和 MapStruct。它们所使用的实现技术不同ModelMapper 是基于反射的通过反射来查找实体对象的字段并读取或写入值这样的方式实现原理简单但性能很差。与 ModelMapper 框架不同的是MapStruct 是基于编译阶段代码生成的生成的转换代码在运行的时候跟一般的代码一样没有额外的性能损失。本文重点介绍 MapStruct。业务场景假设现在有这么个场景从数据库查询出来了一个 user 对象包含 id用户名密码手机号邮箱角色这些字段和一个对应的角色对象 role包含 id角色名角色描述这些字段现在在 controller 需要用到 user 对象的 id用户名和角色对象的角色名三个属性。一种方式是直接把两个对象传递到 controller 层但是这样会多出很多没用的属性。更通用的方式是需要用到的属性封装成一个类(DTO)通过传输这个类的实例来完成数据传输。实现方式之使用传统方式如下User.javaAllArgsConstructor Data public class User {private Long id;private String username;private String password;private String phoneNum;private String email;private Role role; }Role.javaAllArgsConstructor Data public class Role {private Long id;private String roleName;private String description; }UserRoleDto.javaData public class UserRoleDto {/*** 用户id*/private Long userId;/*** 用户名*/private String name;/*** 角色名*/private String roleName; }MainTest.java测试类模拟将 user 对象转换成 UserRoleDto 对象public class MainTest {User user null;/*** 模拟从数据库中查出 user 对象*/Beforepublic void before() {Role role new Role(2L, administrator, 超级管理员);user new User(1L, zhangsan, 12345, 17677778888, 123qq.com, role);}/*** 模拟把 user 对象转换成 UserRoleDto 对象*/Testpublic void test1() {UserRoleDto userRoleDto new UserRoleDto();userRoleDto.setUserId(user.getId());userRoleDto.setName(user.getUsername());userRoleDto.setRoleName(user.getRole().getRoleName());System.out.println(userRoleDto);} }运行结果上边的代码或许暂时看起来还是比较简洁的但是我们需要注意的一点就是平时业务开发中的对象属性远不是上述代码中简简单单的几个字段有可能会有数十个字段同理也会数十个对象需要转换我们如果还是通过 getter、setter 的方式把一个对象属性值复制到另一个对象中去还是非常麻烦的不过不用担心今天要介绍给大家的 MapStruct 就是用于解决这种问题的。实现方式之使用 MapStruct这里我们沿用上述代码中的基本对象 User.java、 Role.java、 UserRoleDto.java。然后新建一个 UserRoleMapper.java这个来用来定义 User.java、 Role.java和 UserRoleDto.java之间属性对应规则。在这之前我们需要引入 MapStruct 的 pom 引用 dependencygroupIdorg.mapstruct/groupIdartifactIdmapstruct-jdk8/artifactIdversion1.3.0.Final/version /dependencyUserRoleMapper.javaimport org.mapstruct.Mapper; import org.mapstruct.Mapping; import org.mapstruct.Mappings; import org.mapstruct.factory.Mappers;/*** Mapper 定义这是一个MapStruct对象属性转换接口在这个类里面规定转换规则* 在项目构建时会自动生成改接口的实现类这个实现类将实现对象属性值复制*/ Mapper public interface UserRoleMapper {/*** 获取该类自动生成的实现类的实例* 接口中的属性都是 public static final 的* 方法都是public abstract 的*/UserRoleMapper INSTANCES Mappers.getMapper(UserRoleMapper.class);/*** 这个方法就是用于实现对象属性复制的方法** Mapping 用来定义属性复制规则* source 指定源对象属性* target 指定目标对象属性** param user 这个参数就是源对象也就是需要被复制的对象* return 返回的是目标对象就是最终的结果对象*/Mappings({Mapping(source id, target userId),Mapping(source username, target name),Mapping(source role.roleName, target roleName)})UserRoleDto toUserRoleDto(User user);}测试一下结果MainTest.java/*** 模拟通过MapStruct把user对象转换成UserRoleDto对象*/Testpublic void test2() {UserRoleDto userRoleDto UserRoleMapper.INSTANCES.toUserRoleDto(user);System.out.println(userRoleDto);}呃很明显运行竟然报错了具体异常如下核心是这一句 java.lang.ClassNotFoundException:Cannotfind implementationfortop.zhoudl.mapstruct.UserRoleMapper ,也就是说没有找到 UserRoleMapper 类的实现类。通过查阅一些资料可得MapStruct 是一个可以处理注解的Java编译器插件可以在命令行中使用也可以在 IDE 中使用。MapStruc t有一些默认配置但是也为用户提供了自己进行配置的途径。缺点就是这玩意在使用工具自带的编译器时不会生成实现类需要通过 maven 的方式来进行编译然后才会生成实现类。所以我们需要增加一个编译插件到 pom 文件中!-- 引入 processor -- dependencygroupIdorg.mapstruct/groupIdartifactIdmapstruct-processor/artifactIdversion1.3.0.Final/versionscopeprovided/scope /dependency !--为 Maven compile plugin 设置 annotation processor -- pluginsplugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-compiler-plugin/artifactIdversion3.5.1/versionconfigurationsource1.8/sourcetarget1.8/targetannotationProcessorPathspathgroupIdorg.mapstruct/groupIdartifactIdmapstruct-processor/artifactIdversion1.2.0.Final/version/path/annotationProcessorPaths/configuration/plugin /plugins然后我们运行程序就可以得到自己想要的结果了安装 MapStruct 插件使用 MapStruct还有一个缺点就是当属性改名的时候因为在 Mapper 上注解中配置的名字是在字符串里面因此不会自动同步的。所以 MapStruct 提供了一个插件来解决这个问题同时还提供代码自动提示、点击跳转到实现等功能。关于插件的更多信息参见 MapStruct support for IntelliJ IDEA安装插件的过程在 IDEA 中依次打开 File - Settings - Plugins然后在 Markeyplace 搜索框中输入 mapstruct点击 install然后重启 IDE 即可。一些可能会出现的问题找不到注释处理程序在 pom.xml 中增加 mapstruct-processor 的依赖没有找到实现类在 pom.xml 中加入对 mapstruct-processor 的依赖在 IDEA 里面 enable Annotation Processor使用 Lombok 的情况下编译时报 Data 类的 setter/getter 找不到把 lombok 加入到annotationProcessorPath如下图总结MapSturct 是一个生成类型安全 高性能且无依赖的 JavaBean 映射代码的注解处理器annotation processor。作为一个注解处理器 通过 MapStruct 生成的代码具有怎么样的优势呢抓一下重点注解处理器可以生成 JavaBean 之间的映射代码类型安全 高性能 无依赖性高性能这是相对反射来说的 反射需要去读取字节码的内容 花销会比较大。而通过 MapStruct来生成的代码 其类似于人手写代码执行速度上可以得到保证。前面例子中生成的代码可以在编译后看到在项目的 target/generated-sources/annotations 目录里可以看到具体代码。易于 debug在我们生成的代码中 我们可以轻易的进行 debug。但是如果是使用反射实现代码的时候 一旦出现了问题 很多时候是比较难找到原因。使用相对简单如果是完全映射的 使用起来肯定没有反射简单。用类似 BeanUtils 这些工具一条语句就搞定了。但是如果需要进行特殊的匹配特殊类型转换 多对一转换等 MapStruct 的优势就比较明显了基本上我们只需要在使用的时候声明一个接口 接口下写对应的方法 就可以使用了当然 如果有特殊情况 是需要额处理一下的。代码独立生成的代码是对立的 没有运行时的依赖原作者zhoudl原文链接业务代码的救星——Java 对象转换框架 MapStruct 妙用原出处公众号