SuperAPI AI 工具集

mapstruct-plus

编程与开发

查看项目

更新于 10-15 23:43

技能介绍

用途:MapStruct Plus 是 MapStruct 的增强工具,基于 JSR 269 注解处理器,只需在类上加 @AutoMapper 等注解即可自动生成双向对象转换代码,免去手写 Mapper 接口。适用于 Java/Spring Boot 项目中的 DTO 与 Entity、VO 与 DTO 之间的转换,可替代 BeanUtils.copyProperties、ModelMapper 等对象拷贝方式。

主要能力:支持 @AutoMapper、@AutoMapping、@AutoMappers、@AutoEnumMapper、@AutoMapMapper、@ReverseAutoMapping、@MapperConfig、@ComponentModelConfig、@Immutable 等注解;可处理不同属性名映射、日期与数字格式、忽略映射、默认值、表达式、一对多转换、枚举转换、Map 转对象、循环引用(cycleAvoiding)及嵌套对象递归转换;自定义转换器通过 uses 与 qualifiedByName 引用;Converter 提供 convert 方法用于创建新对象、更新已有对象、列表批量转换、Map 转对象等。

使用方式:Spring Boot 环境引入 mapstruct-plus-spring-boot-starter,并在 maven-compiler-plugin 的 annotationProcessorPaths 中配置 mapstruct-plus-processor;配合 Lombok(>=1.18.16)时需加 lombok-mapstruct-binding 0.2.0。非 Spring Boot 环境使用 mapstruct-plus 依赖,配置 @ComponentModelConfig(componentModel = "default") 并用 new Converter()。随后在类上声明 @AutoMapper(target = 目标类.class),通过注入的 Converter 执行转换。生成代码位于 target/generated-sources。

限制与注意:MapStruct Plus 已内嵌 MapStruct,不应再引入 MapStruct 依赖以避免版本冲突;Map 转对象需引入 hutool-core(1.4.0+);spring-boot-devtools 可能引发异常,建议去掉。常见问题包括 cannot find converter、Couldn't retrieve @Mapper、NoSuchMethodError: Adapter 等,可先执行 mvn clean compile 并检查依赖与扫描包。其余版本、平台与授权信息暂未提供。