本文介绍在不修改原始 pojo 类的前提下，通过 mapstruct 框架自动处理 20+ 字段的非空判空与属性映射，显著降低方法认知复杂度，替代冗长 if 链。
本文介绍在不修改原始 pojo 类的前提下，通过 mapstruct 框架自动处理 20+ 字段的非空判空与属性映射，显著降低方法认知复杂度，替代冗长 if 链。
当一个 Java 方法需要对源对象的数十个字段逐个执行 if (field != null) 判空并赋值到目标对象时（如 assignFruit），代码会迅速膨胀为难以维护、高圈复杂度（Cognitive Complexity）的“if 堆叠”。手动展开不仅违反 DRY 原则，还极易因遗漏字段或误写 setter 导致运行时异常。
此时，引入 MapStruct 是一种专业、简洁且类型安全的重构方案。它在编译期生成高效、可读的映射代码，天然支持空值策略控制，无需反射或运行时代理，性能接近手写。
✅ 正确使用 MapStruct 实现空值安全映射
首先，添加 MapStruct 依赖（Maven）：
<dependency><groupid>org.mapstruct</groupid><artifactid>mapstruct</artifactid><version>1.5.5.Final</version></dependency>
并配置注解处理器（Gradle 或 Maven 需启用 annotation processor）。
接着，定义一个仅含接口的映射器，并声明空值忽略策略：
@Mapper(
nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE,
componentModel = "spring" // 可选：集成 Spring 容器
)
public interface FruitBasketMapper {
FruitBasketMapper INSTANCE = Mappers.getMapper(FruitBasketMapper.class);
FruitBasket2 fruitBasket1ToBasket2(FruitBasket1> source);
}
⚠️ 注意：
FruitBasket1与FruitBasket2的字段名（如name,number,color,region）需保持一致（大小写敏感），MapStruct 才能自动匹配并生成if (source.getName() != null) target.setName(...)形式的判空逻辑 —— 这正是你原始assignFruit方法所做，但由框架全自动完成，且扩展至 20+ 字段零额外成本。
调用方式极其简洁：
private void assignFruit(FruitBasket1> fruit1, FruitBasket2 fruit2) {
// 一行替代全部 if 语句
FruitBasketMapper.INSTANCE.fruitBasket1ToBasket2(fruit1);
// 注意：上述默认返回新实例；若需“就地更新”fruit2，请改用 @BeanMapping + @Mapping(target="...", expression=...)，
// 或更推荐：让 mapper 接受两个参数并标注 @MappingTarget
}
? 进阶：就地更新（In-Place Mapping）
若必须复用已有 fruit2 实例（而非新建），可调整接口如下：
@Mapper(nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE)
public interface FruitBasketMapper {
FruitBasketMapper INSTANCE = Mappers.getMapper(FruitBasketMapper.class);
void updateFruitBasket2(@MappingTarget FruitBasket2 target, FruitBasket1> source);
}
生成的实现将直接调用 target.setName(...) 等 setter，完全等价于你原始逻辑，但彻底消除重复模板代码。
? 关键优势总结
- 零运行时开销：纯编译期生成，无反射、无代理；
- 强类型安全：字段名/类型错误在编译期即暴露；
- 可维护性跃升：新增字段只需保证命名一致，无需修改映射逻辑；
-
策略统一可控：除
IGNORE外，还支持SET_TO_NULL、SET_TO_DEFAULT等； -
无缝集成：兼容 Lombok（需注意
@Builder或@AllArgsConstructor冲突）、Spring、Quarkus 等生态。
? 替代方案对比：手动提取为
Map<string object></string>+ 循环？易错且丢失类型；自定义泛型工具方法？仍需反射或大量instanceof；Apache Commons BeanUtils.copyProperties()？默认覆盖 null 值，且性能差、线程不安全、弃用风险高。MapStruct 是当前企业级 Java 映射的事实标准。
从此，告别 20 行 if 判空，拥抱声明式、可测试、可持续演进的对象映射。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
