本文共 2473 字，大约阅读时间需要 8 分钟。

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 和上述项目，你可以快速掌握行业前沿技术，构建高效的开发能力。