Spring MVC 中怎么配置类型转换器 Converter 与 Formatter

大晨酱_3816

大晨酱_3816

2026-08-11

201人浏览

原创

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

spring mvc 中怎么配置类型转换器 converter 与 formatter

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);
  }
}

OpenJDK 24
OpenJDK 24

OpenJDK 24 Windows x64 官方参考实现(24+36),适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。

下载
  • 同样在 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 方法做多模式适配。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2551

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

457

25

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

20

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

0

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

0

10

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

0

15

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

2026.10.16

0

15

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

2026.10.16

20

15

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

2026.10.15

20

20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习