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

你是否还在为对象映射转换写一堆重复的 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 大核心优势

快速上手：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 一键映射

当源对象和目标对象字段名不同（如 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; // 对应源对象的 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

赶紧用起来，让对象映射从此成为“举手之劳”！如果觉得有用，别忘了转发给身边的同事哦～