MapStruct 超神用法，让你的代码效率提升十倍！

今天我们来聊聊一个神奇的工具——MapStruct。作为一名技术，我总是希望我的代码既简洁又高效，而MapStruct恰恰可以满足这些需求。你可能会问，MapStruct到底是什么？别急，我们慢慢来。

什么是 MapStruct？

简单来说，MapStruct 是一个用于 Java 的代码生成器，专注于对象之间的映射。它通过注解的方式来定义如何将一个对象的属性映射到另一个对象。这听起来可能有些复杂，但其实它的核心思想就是简化对象转换的工作。 在现代开发中，尤其是微服务架构下，数据传输对象（DTO）和实体之间的映射工作变得越来越频繁。如果没有一个高效的工具，手动编写这些映射代码不仅容易出错，还会让人感到厌烦。而MapStruct的出现，正好解决了这个痛点。

为什么选择 MapStruct？

1. 自动化对象映射的重要性

想象一下，每次你需要转换对象时，都得手动写一大堆映射代码，真是让人头疼！MapStruct 通过自动生成代码来减少开发工作量，从而提升了开发效率。你只需简单地定义映射规则，MapStruct 会在编译时生成所需的代码。这就像是让你雇佣了一个能干的助理，所有繁琐的工作都交给他处理，你只需专注于核心业务逻辑。

2. MapStruct 的主要特性

简洁性

MapStruct 通过注解的方式定义映射规则，比如：

@Mapper
public interface UserMapper {
    UserMapper INSTANCE = Mappers.getMapper(UserMapper.class);

    UserDto userToUserDto(User user);
}

这样就能自动生成 userToUserDto 方法，简直是太简单了！

性能优秀

MapStruct 在编译时生成代码，避免了运行时使用反射的开销。这意味着你不仅能享受到简洁的代码，还能获得更高的性能。

安全性

MapStruct 的一个大优势是它的类型安全。在编译期间，如果你尝试映射不兼容的类型，编译器会立刻给你反馈，帮助你快速发现潜在问题。比如，如果你将一个字符串映射到一个整数，编译器会报错，省去你运行时调试的麻烦。

灵活性

MapStruct 支持自定义转换和映射策略。这意味着你可以根据项目的具体需求，灵活地调整映射逻辑，而不仅仅是默认行为。

IDE 支持

如果你像我一样，热爱使用 IDE 的自动完成功能和错误高亮，MapStruct 完美集成了这些功能，帮助你快速开发。

MapStruct 的进阶用法

让我们深入一些进阶用法，这些功能会让你的代码更加高效、优雅。

3.1 使用 expression

有时候，你可能需要在映射过程中执行一些复杂的逻辑。这个时候，可以使用 @Mapping 注解中的 expression 属性。例如：

@Mapper
public interface UserMapper {
    @Mapping(target = "fullName", expression = "java(user.getFirstName() + \" \" + user.getLastName())")
    UserDto userToUserDto(User user);
}

这样， fullName 字段就会被设置为用户的全名。

3.2 使用 qualifiedByName

如果你需要自定义转换逻辑，比如将字符串转换为大写，可以使用 @Mapping 的 qualifiedByName 属性：

@Mapper
public interface UserMapper {
    @Mapping(target = "username", source = "user.name", qualifiedByName = "toUpperCase")
    UserDto userToUserDto(User user);

    @Named("toUpperCase")
    static String toUpperCase(String name) {
        return name.toUpperCase();
    }
}

这样， username 字段将会被转换为大写。

3.3 使用 nullValueMappingStrategy

默认情况下，当源对象的值为 null 时，目标对象的相应字段也会设置为 null 。但有时我们希望返回一个默认值，比如一个空列表。可以通过 @Mapping 中的 nullValueMappingStrategy 属性来实现：

@Mapper
public interface UserMapper {
    @Mapping(target = "roles", nullValueMappingStrategy = NullValueMappingStrategy.RETURN_DEFAULT)
    UserDto userToUserDto(User user);
}

这样，如果 user.getRoles() 返回 null ， roles 字段将会被设置为一个空列表，而不是 null 。

3.4 使用 Decorator

MapStruct 的 Decorator 功能让我们能够实现一些全局处理逻辑。比如，你可以在 Mapper 接口中添加一个装饰器，以便在每次调用映射方法时执行特定的逻辑：

@Mapper
public interface UserMapper {
    UserDto userToUserDto(User user);

    @Decorator
    class UserMapperDecorator implements UserMapper {
        private final UserMapper delegate;

        public UserMapperDecorator(UserMapper delegate) {
            this.delegate = delegate;
        }

        @Override
        public UserDto userToUserDto(User user) {
            UserDto dto = delegate.userToUserDto(user);
            // 在这里可以添加额外的逻辑
            dto.setProcessed(true); // 举个例子
            return dto;
        }
    }
}

通过这种方式，你可以灵活地在映射逻辑中插入全局处理。

总结

MapStruct 作为一个对象映射工具，凭借其简洁性、高效性和灵活性，让我们的代码变得更加优雅。通过自动生成映射代码，避免了繁琐的手动编码，同时提升了性能和安全性。无论是基本的映射，还是进阶的自定义逻辑，MapStruct 都能轻松应对，让你的代码效率提升十倍，简直是程序员的福音！ 希望今天的分享能帮助你更好地理解 MapStruct，并在实际项目中充分利用它的强大功能。代码要简洁，心情要愉悦，让我们一起用 MapStruct 让编码变得更轻松吧！
-END - ok，今天先说到这，老规矩，看完文章记得右下角给何老师点赞。 最后送给大家一个福利，我这里有一份搞副业的教程，这份教程里有 100+个搞钱小项目 ： 网盘拉新核心玩法、公众号运营变现、 小红书虚拟资料引流 等，现在扫码加我微信，即可领取这份副业教程。 添加时备注： 副业