MapStruct入深：高级映射技巧与实践

MapStruct 是一个强大的 Java 编译时注解处理框架，专注于高效、安全地实现 Java Bean 对象到另一种类型对象的映射。与传统的反射式映射工具不同，MapStruct 通过在编译时生成代码，显著提升了性能和代码简洁性。本文将深入探讨 MapStruct 的高级功能，助力开发者更高效地完成对象转换任务。

1. 表达式映射

在 MapStruct 中，开发者可以通过注解直接指定 Java 表达式，实现更复杂的映射需求。例如，可以将 System.currentTimeMillis() 映射到目标对象的 createTime 字段。以下是一个典型示例：

@Mapper(componentModel = "spring")public interface MyMapper {    Target toTarget(Source source);}

在编译生成的代码中，createTime 字段将被赋值为 System.currentTimeMillis()，实现了直接的时间戳映射。

2. 有条件映射

默认情况下，MapStruct 会通过 get 和 set 方法进行字段映射。然而，在某些场景下，这种直接映射可能无法满足需求。例如，如果需要将 name 字段转换为大写格式，可以使用 qualifiedByName 特性。

@Mapper(componentModel = "spring")public interface MyMapper {    @Mapping(target = "name", source = "name", qualifiedByName = "toUpperCase")    Target toTarget(Source source);}@Named("toUpperCase")default String toUpperCase(String value) {    return value != null ? value.toUpperCase() : null;}

在编译生成的代码中，name 字段会被自动转换为大写形式，满足特定格式需求。

3. 处理空值

nullValueMappingStrategy 是 MapStruct 的一个重要特性，用于处理源数据为 null 时的目标映射策略。默认情况下，目标字段会被设置为 null。但在某些场景下，可能需要将空值替换为默认值。例如，可以使用 RETURN_DEFAULT 策略将空列表替换为空集合。

@Mapper(componentModel = "spring", nullValueMappingStrategy = NullValueMappingStrategy.RETURN_DEFAULT)public interface MyMapper {    Target toTarget(Source source);}

在编译生成的代码中，当源数据或关联字段为 null 时，目标字段会被设置为默认值（如空集合），从而避免了空对象带来的潜在问题。

4. 装饰器模式

MapStruct 提供了装饰器模式，允许开发者对映射逻辑进行扩展和修饰。通过创建自定义装饰器类，可以对目标对象的字段进行额外处理。

public abstract class YourMapperDecorator implements YourMapper {    private final YourMapper delegate;    public YourMapperDecorator(YourMapper delegate) {        this.delegate = delegate;    }    @Override    public Target toTarget(Source source) {        Target result = delegate.toTarget(source);        if (result != null) {            if (result.getField() == null) {                result.setField("");            }            // 可以对其他字段进行类似的处理...        }        return result;    }}

在映射接口上添加装饰器注解：

@Mapper@DecoratedWith(YourMapperDecorator.class)public interface YourMapper {    Target toTarget(Source source);}

这样，每次调用 toTarget 方法时，装饰器逻辑都会被执行，可以实现对空字段的默认值处理等功能。

5. 推荐学习项目

如果你对 MapStruct 的学习后想要实践项目，可以考虑以下电商购物系统：

1. 基于 Spring Boot 的单体版本

技术栈：Spring Boot 2.7、MyBatis Plus、RabbitMQ、Elasticsearch、Redis

功能模块：商品浏览、搜索、评论、规格选择、购物车、下单、支付、发货、退货等

代码仓库：MarkerHub

2. 基于 Spring Cloud Alibaba 的微服务版本

技术栈：Spring Cloud Alibaba 2021.0.5.0、Nacos、Seata、OpenFeign、Sentinel

功能架构：分布式服务发现、全局事务、微服务调度等

代码仓库：MarkerHub

通过学习 MapStruct 和上述项目，你可以快速掌握行业前沿技术，构建高效的开发能力。

转载地址：http://cgufk.baihongyu.com/

你可能感兴趣的文章