spring mvc 中 converter 用于通用单向类型转换(如 string→enum),formatter 侧重带格式的双向字符串↔对象转换(如日期格式化)并支持国际化;二者均通过 webmvcconfigurer 的 addformatters 注册,xml 配置需显式定义 conversionservice 并绑定到 mvc:annotation-driven。

Spring MVC 中配置 Converter 和 Formatter 的核心在于注册到 ConversionService,并让 WebMvcConfigurer 或 XML 配置将其生效。两者用途不同:Converter 用于通用类型转换(如 String → Enum、String → Date),Formatter 更侧重带格式的双向字符串 ↔ 对象转换(如 "2025年03月12日" ↔ LocalDate),且天然支持国际化。
Converter 配置方式(Java 配置类)
适用于需要将一种非字符串类型转为另一种类型,或跨类型转换(如 String → 自定义枚举、Integer → User)。必须实现 org.springframework.core.convert.converter.Converter<s t></s> 接口。
- 编写 Converter 类,例如将字符串转为 StatusEnum:
public class StringToStatusConverter implements Converter
@Override
public StatusEnum convert(String source) {
return StatusEnum.fromString(source);
}
}
- 在 WebMvcConfigurer 实现类中注册:
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addFormatters(FormatterRegistry registry) {
registry.addConverter(new StringToStatusConverter());
}
}
- 注意:addFormatters 方法会自动将 Converter 和 Formatter 统一注册进底层的 DefaultFormattingConversionService,无需额外声明 ConversionService bean。
Formatter 配置方式(Java 配置类)
专用于字符串与目标对象之间的格式化/解析,比如日期、货币、自定义文本格式。必须实现 org.springframework.format.Formatter<t></t> 接口(内部含 parse 和 print 方法)。
- 示例:支持 “yyyy年MM月dd日” 格式的 LocalDate 转换:
public class CustomDateFormatter implements Formatter
private final DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy年MM月dd日");
@Override
public LocalDate parse(String text, Locale locale) throws ParseException {
return LocalDate.parse(text, formatter);
}
@Override
public String print(LocalDate object, Locale locale) {
return object.format(formatter);
}
}
- 同样在 addFormatters 中注册:
registry.addFormatter(new CustomDateFormatter());
- Formatter 会自动参与 @DateTimeFormat 注解的解析,也支持 @NumberFormat;它比 Converter 更适合处理用户输入的可读格式。
XML 配置方式(传统 Spring MVC 项目)
若仍使用 XML 配置,需显式定义 ConversionService 并绑定到 mvc:annotation-driven。
- 定义自定义 Converter bean:
- 组装 ConversionService:
- 启用该服务:
- 注意:id 必须与 conversion-service 属性值一致;不能用默认的 "conversionService" 作为 id(否则可能因 Bean 冲突导致异常)。
关键区别与选型建议
Converter 和 Formatter 不是互斥关系,而是互补:
- Converter 更通用,可用于 Service 层、DAO 层等任意 Spring 环境;Formatter 仅限 Web 层,依赖 Locale,适合展示/输入场景。
- Formatter 本质是组合了 Parser(字符串→对象)和 Printer(对象→字符串),而 Converter 是单向的。
- Spring Boot 项目推荐 Java 配置 + addFormatters;老项目维护可沿用 XML 方式。
- 若需支持多种日期格式(如同时接受 "yyyy-MM-dd" 和 "yyyyMMdd"),优先考虑 GenericConverter 或自定义 Formatter 的 parse 方法做多模式适配。











