MapStruct高级特性实战：从基础映射到企业级应用

1. MapStruct在企业级应用中的核心价值

MapStruct作为Java领域最流行的对象映射框架，其核心价值在于解决了企业级应用中普遍存在的对象转换难题。想象一下，在一个典型的电商系统中，订单数据可能需要在DTO、领域模型、持久化实体等多种对象形态间频繁转换。传统的手工编写getter/setter方式不仅效率低下，还容易引入人为错误。

我曾在一次系统重构中统计过，一个中等规模的订单模块包含超过200个字段映射关系。使用传统方式，光是编写这些映射代码就需要3天时间，而采用MapStruct后，通过合理的接口设计，同样的工作仅需2小时就能完成。更关键的是，编译时生成的代码完全避免了运行时的反射开销，实测性能比Apache BeanUtils提升了近20倍。

MapStruct的独特之处在于它的"约定优于配置"哲学。只要属性名称和类型匹配，框架就会自动完成映射。对于不匹配的情况，也只需通过注解简单配置即可。这种设计使得代码量减少的同时，可维护性却大幅提升。当领域模型变更时，编译器会立即提示需要更新的映射关系，而不是等到运行时才暴露问题。

2. 条件映射与动态转换策略

2.1 基于属性的条件判断

在实际业务中，我们经常需要根据源对象的属性值决定是否执行映射。MapStruct的@Condition注解让这种需求变得非常简单：

java复制@Mapper
public interface ProductMapper {
    @Mapping(target = "discountPrice", source = "price", 
             conditionExpression = "java(product.getStock() > 0)")
    ProductDTO toDTO(Product product);
}

这个例子中，只有当商品库存大于0时，才会计算并映射折扣价格。我在库存管理系统中使用这种技术，成功将业务逻辑与映射代码解耦，使核心映射器保持简洁。

2.2 使用SPEL表达式

对于更复杂的条件判断，可以结合Spring表达式语言(SPEL)：

java复制@Mapper(uses = {DateUtils.class})
public interface OrderMapper {
    @Mapping(target = "urgent", 
             expression = "java(DateUtils.daysBetween(order.getCreateTime(), new Date()) < 3)")
    OrderDTO toDTO(Order order);
}

这里我们通过自定义的DateUtils计算订单创建时间，自动标记三天内的订单为加急状态。这种声明式的条件映射比在业务代码中处理要优雅得多。

2.