解决 MapStruct 错误：Java 映射中没有名为“contact.holders.emails”的属性

解决 MapStruct 中“没有名为“contact.holders.emails”的属性”问题

方法一：基于Java的解决方案，使用MapStruct注解解决字段继承映射问题

// AccountMapper.java: Handling mapping between Account and DepositAccount models
@Mapper(componentModel = MappingConstants.ComponentModel.SPRING)
public interface AccountMapper {
    // Map the account source to depositAccount target with field corrections
    @Mapping(source = "account.contact.holders.emails", target = "depositAccount.contact.holders.email")
    com.model5.AccountWithDetailsOneOf map(com.model6.DepositAccount account);
}

// Alternative solution with custom mapping logic using expression in MapStruct
@Mapper(componentModel = MappingConstants.ComponentModel.SPRING)
public interface AccountMapper {
    @Mapping(source = "account", target = "depositAccount")
    @Mapping(target = "depositAccount.contact.holders.email", expression = "java(mapEmails(account.getContact().getHolders()))")
    com.model5.AccountWithDetailsOneOf map(com.model6.DepositAccount account);
}

// Utility method to handle the emails mapping manually
default List<String> mapEmails(List<AccountHolder> holders) {
    return holders.stream()
                  .map(AccountHolder::getEmails)
                  .flatMap(Collection::stream)
                  .collect(Collectors.toList());
}

替代方法：使用自定义映射逻辑解决继承映射问题

方法 2：使用 Spring 中的服务层手动处理复杂的映射

// AccountService.java: Use a service to handle mapping logic more explicitly
@Service
public class AccountService {
    public AccountWithDetailsOneOf mapDepositAccount(DepositAccount account) {
        AccountWithDetailsOneOf target = new AccountWithDetailsOneOf();
        target.setEmail(mapEmails(account.getContact().getHolders()));
        // other mappings here
        return target;
    }

    private String mapEmails(List<AccountHolder> holders) {
        return holders.stream()
                     .flatMap(holder -> holder.getEmails().stream())
                     .collect(Collectors.joining(","));
    }
}

测试和验证：帐户映射的单元测试

方法 3：对不同环境的映射逻辑进行单元测试

// AccountMapperTest.java: Unit tests for the mapper
@SpringBootTest
public class AccountMapperTest {
    @Autowired
    private AccountMapper accountMapper;

    @Test
    public void testEmailMapping() {
        DepositAccount source = new DepositAccount();
        // Set up source data with emails
        AccountWithDetailsOneOf result = accountMapper.map(source);
        assertEquals("expected email", result.getEmail());
    }

    @Test
    public void testEmptyEmailMapping() {
        DepositAccount source = new DepositAccount();
        source.setContact(new Contact());
        AccountWithDetailsOneOf result = accountMapper.map(source);
        assertNull(result.getEmail());
    }
}

有关 MapStruct 映射和超类字段的常见问题

1. 是什么导致 MapStruct 中出现“无属性命名”错误？
2. 当 MapStruct 由于源对象和目标对象之间的继承或字段名称不匹配而无法找到字段时，会发生此错误。使用 @Mapping 使用自定义表达式来解决它。
3. 如何处理 MapStruct 中超类的映射字段？
4. 要映射超类中的字段，您可以在 @Mapping 注解来手动处理这些字段，确保 MapStruct 正确引用它们。
5. Lombok 会影响 MapStruct 映射字段的能力吗？
6. 是的，Lombok 生成的 getter 和 setter 可能并不总是能被识别，特别是当它们位于超类中时。确保 @Getter 和 @Setter 覆盖继承的领域。
7. 如何修复域模型之间的字段名称不匹配？
8. 使用 @Mapping 注释来映射具有不同名称的字段，明确指定正确的源和目标字段名称。
9. 是否可以在 MapStruct 中自动映射集合？
10. 是的，您可以使用自动化集合映射 flatMap() 在自定义方法中，它将嵌套集合转换为平面结构。

关于解决 MapStruct 中映射错误的最终想法

处理不同版本的域模型之间的字段不匹配可能很棘手，尤其是在处理 Java 中的继承字段时。通过定制 映射结构 映射器并利用方法提取超类字段，开发人员可以有效地解决“无属性命名”警告等错误。

了解 Java 继承和框架如何 龙目岛 与 MapStruct 交互至关重要。这使您能够在不影响代码质量的情况下应对这些挑战。这些解决方案可确保大型模块化项目中多个版本之间的无缝对象映射。