Spring 控制器如何使用自定义转换器？

Spring 控制器自定义转换器配置指南

在 Spring 框架中，转换器是一种强大的工具，用于将请求参数或表单字段的值转换为适当的类型。通过自定义转换器，您可以轻松扩展 Spring 的类型转换功能，以满足特定业务需求。

问题：控制器中无法使用自定义转换器

在 Spring 3.0.5 及更早版本中，将自定义转换器直接配置在 XML 中可能无法在控制器中正常工作。这是因为控制器使用一个名为 FormattingConversionService 的扩展转换服务，而直接配置的转换器添加到基础的 ConversionService 中。

解决方案：

为了将自定义转换器添加到控制器使用的转换服务，有两种方法：

• 使用 @EnableFormattingConversionService 注解：

此注解可以启用自动配置，使用 FormattingConversionServiceFactoryBean 创建格式化转换服务。然后，您可以将自定义转换器注册到此服务中，如下所示：

@Configuration
public class CustomConversionConfig {

    @Bean
    public ConversionService conversionService() {
        FormattingConversionService conversionService = new FormattingConversionService();
        conversionService.addConverter(new StringToMyTypeConverter());
        return conversionService;
    }
}

• 手动注册转换器：

您也可以手动将转换器注册到 FormattingConversionService 中，方法是在 WebMvcConfigurerAdapter 或 WebMvcConfigurationSupport 的 configureFormatters 方法中将其添加：

public class CustomConverterConfigurer extends WebMvcConfigurerAdapter {

    @Override
    public void configureFormatters(FormatterRegistry registry) {
        registry.addConverter(new StringToMyTypeConverter());
    }
}

为何不使用 PropertyEditor？

虽然使用 PropertyEditor 可以解决某些问题，但将其添加到所有绑定器和控制器中并不可取。更好的做法是使用上述两种解决方案之一，因为它们提供了一种更统一和可扩展的方法来注册转换器。

结论

通过使用 @EnableFormattingConversionService 注解或手动注册转换器，您可以将自定义转换器添加到控制器使用的 FormattingConversionService 中。这将允许您在控制器中使用转换器进行数据绑定和格式化。

常见问题解答

• Q：为什么 @EnableFormattingConversionService 注解在较新版本的 Spring 中不可用？

  • A： 在 Spring 4.0 及更高版本中，FormattingConversionService 是默认的转换服务，因此不需要此注解。

• Q：如何为特定字段注册转换器？

  • A： 使用 @ModelAttribute 注解，您可以在控制器方法中为特定字段指定转换器。

• Q：我可以使用 Spring Boot 自动配置来注册转换器吗？

  • A： 是的，Spring Boot 提供了自动配置来注册常用的转换器。您还可以使用 @SpringBootApplication(scanBasePackages = "...") 注解自定义扫描包以查找自定义转换器。

• Q：如何处理转换错误？

  • A： Spring 提供了 ConversionException 来处理转换错误。您可以在控制器中使用 @ExceptionHandler(ConversionException.class) 来捕获和处理这些错误。

• Q：转换器的优先级是如何工作的？

  • A： 转换器按优先级排序，优先级较高的转换器优先使用。您可以使用 Ordered 接口或 @Order 注解来指定转换器的优先级。