当前位置：首页 > news >正文

告别繁琐！MapStruct-Plus 让对象映射效率飙升，这波操作太香了！

news 2026/3/26 20:58:39

你是否还在为对象映射转换写一堆重复的 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();// 转换为 UserInfoDTOUserInfoDTO 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 一键映射

当源对象和目标对象字段名不同（如 username vs loginName），无需手动赋值：

// 源对象：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; // 对应源对象的 usernameprivate 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 {@Autowiredprivate Converter converter;@Testpublic 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)（解密后得到明文）}
}