避免直接注入：巧用 MapStruct 映射器和 Spring 转换
2024-03-05 21:25:42
MapStruct 映射器与 Spring 转换：避免直接注入的巧妙方法
导言
将 MapStruct 映射器与 Spring 转换模型相结合，可以为 Java 开发人员提供一个强有力的对象映射工具集。然而，直接在 MapStruct 映射器之间进行注入会导致代码复杂性和维护困难。本文介绍了一种创新的解决方案，利用 Spring ConversionService 避免直接注入，从而简化映射器配置并提高灵活性。
MapStruct 与 Spring 转换的集成
MapStruct 是一个强大的代码生成工具，可自动生成在 Java 对象之间进行转换的代码。Spring 转换模型则提供了一种机制，将不同类型对象相互转换，从而简化了代码。
将这两项技术结合起来，我们可以通过将 MapStruct 映射器接口声明为 Spring Converter 的扩展来实现：
@Mapper
public interface CarMapper extends Converter<Car, CarDto>
通过注入 ConversionService，我们可以使用 MapStruct 映射器 Bean：
public CarDto getCarInformation(Car car) {
return conversionService.convert(car, CarDto.class);
}
避免直接注入映射器
尽管这种方法有效，但我们可能希望避免直接通过 uses 属性将一些映射器注入到其他映射器中。通过使用 ConversionService 来引用其他映射器，我们希望获得更大的灵活性，并简化映射器的配置。
然而，由于 ConversionService 的 convert 方法与 MapStruct 映射方法的标准模式不同，代码生成插件无法识别它可以在寻找子映射时使用该服务。
自定义 uses 属性
为了解决这个问题，我们可以创建一个自定义的 MapStruct uses 属性实现，该实现接受 ConversionService 作为参数，并使用它来查找和调用其他映射器。
通过创建如下自定义注解，我们可以实现此目的：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.CLASS)
public @interface MapStructWithConversionService {
Class<?>[] value();
}
我们可以将此注解应用于希望使用 ConversionService 的映射器接口，如下所示：
@Mapper
@MapStructWithConversionService(WheelMapper.class)
public interface CarMapper extends Converter<Car, CarDto>
实现自定义 uses 属性
自定义 uses 属性的实现负责使用 ConversionService 查找和调用其他映射器。我们可以通过实现 MapStruct 的 AnnotationProcessor 来实现此目的。
总结
通过结合自定义 uses 属性和 AnnotationProcessor 实现，我们能够在 MapStruct 映射器中避免直接注入，并使用 ConversionService 来使用其他映射器。这为我们提供了更大的灵活性，并简化了映射器的配置。
常见问题解答
-
为什么要避免直接注入映射器？
避免直接注入可以防止代码复杂性，并允许我们使用 ConversionService 来灵活地引用其他映射器。 -
自定义 uses 属性如何工作？
自定义 uses 属性实现使用 ConversionService 来查找和调用其他映射器。 -
实现自定义 uses 属性的步骤是什么？
需要创建一个自定义注解和一个实现 MapStruct AnnotationProcessor 的实现。 -
这种方法有哪些好处？
这种方法提供更大的灵活性，并简化了映射器的配置。 -
我可以从哪里了解更多信息？
有关更多信息，请参阅 Spring Framework 文档和 MapStruct 文档。
