优雅的Java对象转换解决方案 - MapStruct进阶(三)

小郝不负流年
小郝不负流年   + 关注
2021-04-18 22:00:20   阅读1726   评论0

前面我们讲了MapStruct的一些基本的、最常用的一些东西,包括同名属性映射、不同名称属性映射;同时我们也知道了它会自动生成我们定义的转换接口的实现类,实现类的本质还是xx2.set(xx1.get),相当于是一个代码生成器。

本文主要讲一些其他的东西,包括高阶用法探索、异常问题避免等。

1、多转一

1)我们在实际的业务中少不了将多个对象转换成一个的场景。 MapStruct 当然也支持多转一的操作。 

下面放一个代码片段,我们可以看到其对应的信息不仅仅来自一个类, 那么, 我们也可以通过配置来实现多到一的转换。 


  1. @Mapper  
  2. public interface AddressMapper {  
  3.   
  4.     AddressMapper INSTANCE = Mappers.getMapper(AddressMapper.class);  
  5.   
  6.     @Mapping(source = "person.description", target = "description")  
  7.     @Mapping(source = "address.houseNo", target = "houseNumber")  
  8.     DeliveryAddress personAndAddressToDeliveryAddressDto(Person person, Address address);  
  9. }  

2)在多对一转换时, 遵循以下几个原则

  • 当多个对象中, 有其中一个为 null, 则会直接返回 null
  • 如一对一转换一样, 属性通过名字来自动匹配。 因此, 名称和类型相同的不需要进行特殊处理
  • 当多个原对象中,有相同名字的属性时,需要通过 @Mapping 注解来具体的指定, 以免出现歧义(不指定会报错)。 如上面的 description

2、类型转换

在映射@Mapping时可以指定转换方式,例:


  1. @Mapping(target = "birthday", expression = "java(cn.hutool.core.date.DateUtil.format(vo.getBirthday(), \"yyyy-MM-dd HH:mm:ss\"))")  
  2.     })  

更多类型转换可以查看源码如下,具体每个怎么使用暂时不讲解,后续有时间再写吧,有需要的朋友也可以自己研究下。


  1. @Repeatable(Mappings.class)  
  2. @Retention(RetentionPolicy.CLASS)  
  3. @Target({ElementType.METHOD})  
  4. public @interface Mapping {  
  5.     String target();  
  6.   
  7.     String source() default "";  
  8.   
  9.     String dateFormat() default "";  
  10.   
  11.     String numberFormat() default "";  
  12.   
  13.     String constant() default "";  
  14.   
  15.     String expression() default "";  
  16.   
  17.     String defaultExpression() default "";  
  18.   
  19.     boolean ignore() default false;  
  20.   
  21.     Classextends Annotation>[] qualifiedBy() default {};  
  22.   
  23.     String[] qualifiedByName() default {};  
  24.   
  25.     Class resultType() default void.class;  
  26.   
  27.     String[] dependsOn() default {};  
  28.   
  29.     String defaultValue() default "";  
  30.   
  31.     NullValueCheckStrategy nullValueCheckStrategy() default NullValueCheckStrategy.ON_IMPLICIT_CONVERSION;  
  32.   
  33.     NullValuePropertyMappingStrategy nullValuePropertyMappingStrategy() default NullValuePropertyMappingStrategy.SET_TO_NULL;  
  34. }  

3、Spring注入

我们知道只有在接口加上这个@Mapper注解, MapStruct 才会去实现该接口 。 @Mapper 里有个 componentModel 属性,主要是指定实现类的类型,一般用到两个 。

  • default:默认,可以通过 Mappers.getMapper(Class) 方式获取实例对象 ;
  • spring:在接口的实现类上自动添加注解 @Component,可通过 @Autowired 方式注入

4、异常问题避免/个性逻辑调整

我们知道转换的实现类是MapStruct帮我们在编译时自动生成的,实现类文件放在编译目录里面,没有在源代码里面。这会导致一个问题:如果你的java bean有修改字段类型/名称、或去掉一个字段,如果不重新生成覆盖,代码不会报错,你可能也发现不了,但是实际调用执行的时候会报错。

对于这个问题我和同事也讨论了相关优化措施:我们可以把MapStruct当成代码生成器,编译生成的转换器实现类我们把它从编译目录拷贝到源码目录下,这样的话可以预防这个问题,同时我们也不用编写这无意义的代码,只是动动小手迁移一下。另外在源码目录下我们可以做其他的定制逻辑处理调整,不用担心重新编译会覆盖掉我们添加的部分调整代码。

5、相关文章

相关文章列表点击这里,后续深度使用之后,也会继续更新更多关于MapStruct的文章。如果觉得有用,欢迎分享。

对我有用,我要     转载  
文章分类: Java  
所属标签: MapStruct  
  • 0条评论
  • 只看作者
  • 按时间|按热度
  • 由于本人多次涉及需要打印这个证明,而每次都会忘记入口,在网上各种搜索各种摸索很是浪费时间。故本次将操作流程整理记录下来,以备忘。同时也分享给大家。1、打开湖北政务服务网,地址:http://zwfw.hubei.gov.cn/s/index.html2、切换区域到“武汉市”3、在“特色服务”模块找到“(个人)武汉市社会保险公共服务平台”4、进入“(个人)武汉市社会保险公共服务平台”,登录账号密码<imgsrc="https://cdnstatic.hoscen.cn/blog/article/184053017752895488/img/497065960be44747825acb86a17483c1.png"style=
  • java中的注解@Generated用来标注源代码中的某些东西是由某些工具生成的,而不是人写的。这个注解可以用于:包、类、注解类、方法、构造方法、变量、本地变量、方法参数。
  • 如何使用postman模拟http发送xml参数报文的POST请求?1、postman工具通过安装软件或使用谷歌插件都可以,这里不再赘述。2、配置postman,选择POST,填写URL;切换到Headers,添加Content-Type:text/xml 3、切换到body,选择raw,XML,下方填写你的请求报文4、点击Send发送请求,如图可以看到响应状态、时间、结果等信息5、讲到这里就结束了,是不是学会了?快去试试吧!
  • 解决办法:是idea的加载有问题,关闭IDEA,在工程的根目录下删除.idea文件,重新打开IDEA加载就好了。
  • Failedtoloadprojectconfiguration:cannotparsefileF:/xx/.idea/modules.xml:ParseErrorat[row,col]:[1,1]Message:文件提前结束。解决办法:关闭idea,删掉这个文件,重新打开idea
  • 建立服务器内网其他IP端口的隧道,可以将远程的服务映射到本地进行访问。finalshell配置隧道方法:
  • 上传图片微服务网关报错:UT000054:Themaximumsize1048576foranindividualfileinamultipartrequestwasexceeded原因:所用容器对文件的限制一般项目用的是spring 对spring参数进行配置即可spring:servlet:multipart:#MultipartPropertiesmax-request-size:10MB#总文件大小max-file-size:10MB#单个文件大小注意如果是nginx代理配置限制,报错信息里面会标记nginx。届时需要设置nginx在server_name下加上client_max_body_size20m;
  • 目录:1、安装node.js环境2、安装cnpm3、安装vue-cli脚手架构建工具4、用vue-cli构建项目5、安装项目所需的依赖6、项目运行7、项目打包1、安装node.js环境下载地址:https://nodejs.org/zh-cn/安装过程没有太多好说的,安装完成后 win+R打开命令行输入node -v , 如图,出现版本号说明安装成功。npm包管理器是集成在node中的 , npm -v可以查看版本2、安装cnpm由于有些npm有些资源被屏蔽或者是国外资源的原因,经常会导致用npm安装依赖包的时
  • 控制台信息:Unabletostartthedaemonprocess.Thisproblemmightbecausedbyincorrectconfigurationofthedaemon.Forexample,anunrecognizedjvmoptionisused.PleaserefertotheUserManualchapteronthedaemonathttps://docs.gradle.org/6.3/userguide/gradle_daemon.htmlProcesscommandline:E:\DevelopTools\Java\OpenJDK8U-jdk_x86-32_windows_hotspot_8u282b08\jdk8u282-b08\bin\java.exe-XX:MaxHeapSize=1024m-Xms1024m-Xmx2048m-Dfile.encoding=UTF-8-Duser.country=CN-Duser.language=zh-Duser.variant-cpE:\DevelopTools\gradle-6.8.2-all\gradle_resp\wrapper\dists\gradle-6.3-bin\8tpu6egwsccjzp10c1jckl0rx\gradle-6.3\lib\gradle-launcher-6.3.jarorg.gradle.launcher.daemon.bootstrap.GradleDaemon6.3Pleasereadthefollowingprocessoutputtofindoutmore:-----------------------ErroroccurredduringinitializationofVMCouldnotreserveenoughspacefor2097152KBobjectheapPickedupJAVA_
  • 问题maven同一个版本号部署远程仓库,出现报错:Returncodeis: 400,ReasonPhrase:Repositorydoesnotallowupdatingassets:maven-releases. 解决maven在部署(deploy)时候抛的异常,存储库不允许更新资产,这个就是和私有maven库更新策略有关。具体设置步骤:1.访问私有库管理界面http://xxx.xxx.xxx.xxx:80812.登录管理员账号(默认:admin/admin123)3.进入设置界面->repository->repositories->maven-releases(自己需要部署的目标库)->setting->Deploymentpollcy(Allowredeploy)允许更新