你是否还在为对象映射转换写一堆重复的 getter/setter？是否因 Apache BeanUtils 的性能问题头疼？又或是觉得 MapStruct 的手动定义 Mapper 接口不够“智能”？
今天要给大家安利一款“效率神器”——MapStruct-Plus。作为 MapStruct 的增强版，它不仅完美继承了 MapStruct 的编译期转换、高性能优势，还通过“自动生成 Mapper 接口”等黑科技，让 Java 类型转换变得简单到离谱！
MapStruct-Plus：不止于“增强”，更是“解放双手”
1. 它到底是什么？
MapStruct-Plus 是基于 MapStruct 开发的增强工具，核心目标是让对象映射更简单、更优雅。
- 底层不变：和 MapStruct 一样，基于 JSR 269 注解处理器，编译期生成转换代码，性能远超反射型工具（如 BeanUtils）。
- 无缝兼容：内嵌 MapStruct 核心，已用 MapStruct 的项目可直接替换依赖，无需重构代码。
- 核心升级：最爽的是自动生成 Mapper 接口，不用再手动定义转换接口，开发者只需关注“转换规则”即可。
2. 为什么选它？5 大核心优势
| 优势 | 具体价值 |
|---|---|
| 自动生成 Mapper | 无需手动编写转换接口，加个注解就搞定，少写 N 行模板代码 |
| 增强转换能力 | 支持嵌套对象、集合、Map 转对象等复杂场景，还能自定义转换逻辑 |
| 性能拉满 | 编译期生成原生 Java 代码，转换速度和手写 getter/setter 几乎无差别 |
| 友好的错误提示 | 编译期报错，直接定位到转换问题，告别运行时“莫名其妙”的 Bug |
| 完美兼容 Lombok | 和 @Data、@Builder 等注解无缝配合，避免因“类结构”引发的转换异常 |
快速上手：3 步实现对象转换
以 Spring Boot 项目为例，带你 5 分钟跑通第一个案例。
步骤 1：引入依赖
在pom.xml中添加 starter 和编译插件（以 1.4.0 版本为例）：
<!-- 核心依赖 --> <dependency> <groupId>io.github.linpeilie</groupId> <artifactId>mapstruct-plus-spring-boot-starter</artifactId> <version>1.4.0</version> </dependency> <!-- 编译插件（需配合 Lombok 调整，见下文说明） --> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.1</version> <configuration> <source>1.8</source> <target>1.8</target> <annotationProcessorPaths> <!-- Lombok 依赖（若使用） --> <path> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>${lombok.version}</version> </path> <!-- MapStruct-Plus 处理器 --> <path> <groupId>io.github.linpeilie</groupId> <artifactId>mapstruct-plus-processor</artifactId> <version>1.4.0</version> </path> <!-- Lombok 与 MapStruct 绑定器（Lombok 1.18.16+ 需加） --> <path> <groupId>org.projectlombok</groupId> <artifactId>lombok-mapstruct-binding</artifactId> <version>0.2.0</version> </path> </annotationProcessorPaths> </configuration> </plugin> </plugins> </build>步骤 2：定义对象并加注解
只需在源对象上添加@AutoMapper(target = 目标类.class)，无需手动写 Mapper 接口！
// 源对象：UserInfo @Data @Builder @NoArgsConstructor @AllArgsConstructor @AutoMapper(target = UserInfoDTO.class) // 指定转换目标 public class UserInfo { private String username; private String password; private String mobile; } // 目标对象：UserInfoDTO @Data @Builder @NoArgsConstructor @AllArgsConstructor public class UserInfoDTO { private String username; private String password; private String mobile; }步骤 3：一行代码实现转换
通过Converter工具类的convert方法直接转换，无需注入 Mapper！
public static void main(String[] args) { Converter converter = new Converter(); Faker faker = new Faker(Locale.CHINA); // 模拟一个 UserInfo 对象 UserInfo user = UserInfo.builder() .username(faker.name().fullName()) .password(faker.internet().password()) .mobile(faker.phoneNumber().cellPhone()) .build(); // 转换为 UserInfoDTO UserInfoDTO dto = converter.convert(user, UserInfoDTO.class); System.out.println(user); // 输出：UserInfo(username=万智辉, password=jhd05qtk3w, mobile=18887502718) System.out.println(dto); // 输出：UserInfoDTO(username=万智辉, password=jhd05qtk3w, mobile=18887502718) }是不是比手写 get/set 快 10 倍？这还只是基础操作，更强大的功能还在后面！
实战技巧：这些场景用 MapStruct-Plus 太香了
1. 字段名不一致？@AutoMapping 一键映射
当源对象和目标对象字段名不同（如usernamevsloginName），无需手动赋值：
// 源对象：UserInfo @Data @Builder @NoArgsConstructor @AllArgsConstructor @AutoMapper(target = UserInfoDTO.class) public class UserInfo { @AutoMapping(target = "loginName") // 映射到目标类的 loginName 字段 private String username; private String password; private String mobile; } // 目标对象：UserInfoDTO @Data @Builder @NoArgsConstructor @AllArgsConstructor public class UserInfoDTO { private String loginName; // 对应源对象的 username private String password; private String mobile; } // 转换代码： public static void main(String[] args) { Converter converter = new Converter(); Faker faker = new Faker(Locale.CHINA); UserInfo userInfo = UserInfo.builder() .username(faker.name().fullName()) .password(faker.internet().password()) .mobile(faker.phoneNumber().cellPhone()) .build(); UserInfoDTO dto = converter.convert(userInfo, UserInfoDTO.class); System.out.println(userInfo); // 输出：UserInfo(username=任思聪, password=ry85f0wwwqyf4n, mobile=13165059205) System.out.println(dto); // 输出：UserInfoDTO(loginName=任思聪, password=ry85f0wwwqyf4n, mobile=13165059205) }2. 集合转换？直接传 List + 目标类
批量转换 List 时，无需循环调用单对象转换：
public static void main(String[] args) { Converter converter = new Converter(); Faker faker = new Faker(Locale.CHINA); // 模拟一个 UserInfo 列表 List<UserInfo> userList = new ArrayList<>(); UserInfo user = UserInfo.builder() .username(faker.name().fullName()) .password(faker.internet().password()) .mobile(faker.phoneNumber().cellPhone()) .build(); userList.add(user); // 直接转换为 List<UserInfoDTO> List<UserInfoDTO> dtoList = converter.convert(userList, UserInfoDTO.class); System.out.println(userList); // 输出：[UserInfo(username=马博涛, password=uyxarzq0qji42, mobile=17526506905)] System.out.println(dtoList); // 输出：[UserInfoDTO(loginName=马博涛, password=uyxarzq0qji42, mobile=17526506905)] }3. Map 转对象？加个注解就行
从 Map 转换为实体类时，只需在目标类上加@AutoMapMapper：
// 目标对象：UserInfo（加 @AutoMapMapper 支持 Map 转换） @Data @Builder @NoArgsConstructor @AllArgsConstructor @AutoMapMapper public class UserInfo { private String username; private String password; private String mobile; } // 转换代码： public static void main(String[] args) { Converter converter = new Converter(); Faker faker = new Faker(Locale.CHINA); Map<String, Object> map = new HashMap<>(); map.put("username", faker.name().fullName()); map.put("password", faker.internet().password()); map.put("mobile", faker.phoneNumber().cellPhone()); System.out.println(map); // 输出：{password=ebcnes0s63fwo0, mobile=15124057127, username=刘嘉熙} UserInfo userInfo = converter.convert(map, UserInfo.class); System.out.println(userInfo); // 输出：UserInfo(username=刘嘉熙, password=ebcnes0s63fwo0, mobile=15124057127) }4. 复杂逻辑？自定义转换器搞定
遇到特殊转换（如密码加解密），可自定义转换规则。以“UserInfo 明文密码转 UserInfoDTO 密文密码”为例：
a. 自定义类型转换器
@Component public class UserConvertRule { // 明文 → 密文（UserInfo → UserInfoDTO 时用） @Named("convertPlainTex2Ciphertext") public String convertPlainTex2Ciphertext(String plainText) { return EncryptionUtil.encrypt(plainText); // 假设 EncryptionUtil 是加密工具类 } // 密文 → 明文（UserInfoDTO → UserInfo 时用） @Named("convertCiphertext2PlainText") public String convertCiphertext2PlainText(String ciphertext) { return EncryptionUtil.decrypt(ciphertext); // 解密 } }b. 在字段上指定转换规则
// 源对象：UserInfo（明文密码） @Data @Builder @NoArgsConstructor @AllArgsConstructor @AutoMapper(target = UserInfoDTO.class, uses = UserConvertRule.class) public class UserInfo { @AutoMapping(target = "loginName") private String username; @AutoMapping(qualifiedByName = "convertPlainTex2Ciphertext") // 加密 private String password; private String mobile; } // 目标对象：UserInfoDTO（密文密码） @Data @Builder @NoArgsConstructor @AllArgsConstructor @AutoMapper(target = UserInfo.class, uses = UserConvertRule.class) public class UserInfoDTO { private String loginName; @AutoMapping(qualifiedByName = "convertCiphertext2PlainText") // 解密 private String password; private String mobile; }c. 测试转换效果（Spring 环境下）
@SpringBootTest(classes = MapStructPlusApplication.class) @RunWith(SpringJUnit4ClassRunner.class) public class MapStructPlusTest { @Autowired private Converter converter; @Test public void testCustomConverter() { Faker faker = new Faker(Locale.CHINA); // UserInfo → UserInfoDTO（明文变密文） UserInfo user = UserInfo.builder() .username(faker.name().fullName()) .password("123456") // 明文 .mobile(faker.phoneNumber().cellPhone()) .build(); UserInfoDTO dto = converter.convert(user, UserInfoDTO.class); System.out.println(user); // 输出：UserInfo(username=韦志强, password=123456, mobile=17292765672) System.out.println(dto); // 输出：UserInfoDTO(loginName=韦志强, password=ENC@xxx, mobile=17292765672)（ENC@xxx 是加密后的值） // UserInfoDTO → UserInfo（密文变明文） UserInfoDTO dto2 = UserInfoDTO.builder() .loginName(faker.name().fullName()) .password(EncryptionUtil.encrypt("000000")) // 密文 .mobile(faker.phoneNumber().cellPhone()) .build(); UserInfo user2 = converter.convert(dto2, UserInfo.class); System.out.println(dto2); // 输出：UserInfoDTO(loginName=姜伟祺, password=ENC@yyy, mobile=14577358478) System.out.println(user2); // 输出：UserInfo(username=姜伟祺, password=000000, mobile=14577358478)（解密后得到明文） } }总结：为什么推荐 MapStruct-Plus？
- 效率碾压：自动生成转换代码，告别重复劳动，开发速度提升 50%+。
- 性能无忧：编译期生成代码，比反射工具（如 BeanUtils）快 10 倍以上。
- 灵活强大：支持字段映射、集合转换、自定义逻辑，覆盖 99% 的业务场景。
- 无缝迁移：从 MapStruct 升级零成本，老项目也能轻松接入。
如果你还在为对象转换烦恼，MapStruct-Plus 绝对值得一试！
👉官方文档：https://mapstruct.plus
👉示例代码：https://github.com/lyb-geek/springboot-learning/tree/master/springboot-mapstruct-plus
赶紧用起来，让对象映射从此成为“举手之劳”！如果觉得有用，别忘了转发给身边的同事哦～
