HttpMessageConverter 的作用是什么? 它是如何实现请求体到对象、对象到响应体的自动转换的(特别是 JSON/XML)?
HttpMessageConverter
(HTTP 消息转换器) 是 Spring MVC 框架中一个非常核心的组件,它的主要作用是在 HTTP 请求和响应体与 Java 对象之间进行双向转换。
核心作用:
-
读取请求体 (Request Body) 到 Java 对象:
- 当 Controller 方法的参数使用
@RequestBody
注解时,Spring MVC 会尝试找到一个合适的HttpMessageConverter
来读取 HTTP 请求体的内容 (例如,JSON 或 XML 字符串),并将其反序列化 (deserialize) 成方法参数指定的 Java 对象类型。 - 例如,一个 POST 请求发送了 JSON 数据
{ "name": "John", "age": 30 }
,如果 Controller 方法参数是@RequestBody User user
,那么某个HttpMessageConverter
(如MappingJackson2HttpMessageConverter
) 会负责将这个 JSON 转换为一个User
对象。
- 当 Controller 方法的参数使用
-
将 Java 对象写入响应体 (Response Body):
- 当 Controller 方法使用
@ResponseBody
注解 (或者 Controller 类使用@RestController
注解) 标记时,Spring MVC 会尝试找到一个合适的HttpMessageConverter
来将方法的返回值 (通常是一个 Java 对象) 序列化 (serialize) 成特定格式 (例如,JSON 或 XML 字符串),并将其写入 HTTP 响应体。 - 例如,一个 Controller 方法返回一个
User
对象,如果内容协商确定应该返回 JSON,那么某个HttpMessageConverter
会将User
对象转换为 JSON 字符串并发送给客户端。
- 当 Controller 方法使用
它是如何实现自动转换的 (特别是 JSON/XML)?
这个自动转换过程涉及到以下几个关键步骤和组件:
-
注册
HttpMessageConverter
实例:- Spring MVC (在 Spring Boot 环境下,通常是自动) 会在应用启动时初始化并注册一个
HttpMessageConverter
列表。 - 这些转换器是针对不同数据格式的,例如:
MappingJackson2HttpMessageConverter
: 用于 JSON 格式的转换,它底层使用 Jackson 库。Jaxb2RootElementHttpMessageConverter
: 用于 XML 格式的转换,它底层使用 JAXB (Java Architecture for XML Binding)。MappingJackson2XmlHttpMessageConverter
: 也是用于 XML,但使用 Jackson 的 XML 模块。StringHttpMessageConverter
: 用于纯文本字符串。ByteArrayHttpMessageConverter
: 用于字节数组。- 还有其他用于表单数据、Protobuf 等的转换器。
- Spring Boot 会根据类路径上的依赖自动配置这些转换器。例如,如果
jackson-databind
在类路径上,MappingJackson2HttpMessageConverter
就会被自动注册。
- Spring MVC (在 Spring Boot 环境下,通常是自动) 会在应用启动时初始化并注册一个
-
内容协商 (Content Negotiation) 确定目标媒体类型:
- 对于响应 (对象 -> 响应体):
- Spring MVC 通过
ContentNegotiationManager
来确定应该返回给客户端的媒体类型 (MIME type)。 - 它会考虑:
- Controller 方法上
@RequestMapping
(或其变体) 的produces
属性。 - 客户端请求的
Accept
HTTP 头。 - URL 路径扩展名 (如
.json
,.xml
) 或 URL 参数 (如?format=json
) (如果配置了这些策略)。
- Controller 方法上
- 一旦确定了目标媒体类型 (例如
application/json
)。
- Spring MVC 通过
- 对于请求 (请求体 -> 对象):
- Spring MVC 会查看请求的
Content-Type
HTTP 头,以了解请求体中的数据是什么格式 (例如application/json
)。
- Spring MVC 会查看请求的
- 对于响应 (对象 -> 响应体):
-
选择合适的
HttpMessageConverter
:- 对于响应:
- Spring MVC 会遍历已注册的
HttpMessageConverter
列表。 - 对于每个转换器,它会调用其
canWrite(Class<?> clazz, MediaType mediaType)
方法。 canWrite
方法会检查该转换器是否能够将给定的 Java 对象类型 (clazz
,即 Controller 方法的返回值类型) 序列化为之前内容协商确定的目标媒体类型 (mediaType
)。- 找到第一个返回
true
的转换器,就用它来进行转换。
- Spring MVC 会遍历已注册的
- 对于请求:
- Spring MVC 同样会遍历已注册的
HttpMessageConverter
列表。 - 对于每个转换器,它会调用其
canRead(Class<?> clazz, MediaType mediaType)
方法。 canRead
方法会检查该转换器是否能够将请求的Content-Type
(mediaType
) 反序列化为 Controller 方法参数的目标 Java 对象类型 (clazz
)。- 找到第一个返回
true
的转换器,就用它来进行转换。
- Spring MVC 同样会遍历已注册的
- 对于响应:
-
执行转换 (序列化/反序列化):
- 对于响应 (使用选定的转换器的
write
方法):- 调用选定转换器的
write(T t, MediaType contentType, HttpOutputMessage outputMessage)
方法。 t
是 Controller 返回的 Java 对象。contentType
是协商好的响应媒体类型。outputMessage
提供了写入 HTTP 响应体的方式。- JSON 示例 (使用
MappingJackson2HttpMessageConverter
):- Jackson 的
ObjectMapper
会被用来将 Java 对象序列化为 JSON 字符串。 - 这个 JSON 字符串会被写入到
HttpOutputMessage
的输出流中。
- Jackson 的
- XML 示例 (使用
Jaxb2RootElementHttpMessageConverter
):- JAXB 的
Marshaller
会被用来将带有 JAXB 注解的 Java 对象序列化为 XML 字符串。 - 这个 XML 字符串会被写入到输出流中。
- JAXB 的
- 调用选定转换器的
- 对于请求 (使用选定的转换器的
read
方法):- 调用选定转换器的
read(Class<? extends T> clazz, HttpInputMessage inputMessage)
方法。 clazz
是 Controller 方法参数的目标 Java 对象类型。inputMessage
提供了读取 HTTP 请求体的方式。- JSON 示例 (使用
MappingJackson2HttpMessageConverter
):- Jackson 的
ObjectMapper
会从HttpInputMessage
的输入流中读取 JSON 数据。 - 然后将 JSON 数据反序列化为指定
clazz
类型的 Java 对象。
- Jackson 的
- XML 示例 (使用
Jaxb2RootElementHttpMessageConverter
):- JAXB 的
Unmarshaller
会从输入流中读取 XML 数据。 - 然后将 XML 数据反序列化为指定
clazz
类型的 (带有 JAXB 注解的) Java 对象。
- JAXB 的
- 调用选定转换器的
- 对于响应 (使用选定的转换器的
简而言之,整个过程可以概括为:
- 配置阶段: 注册一系列支持不同媒体类型的
HttpMessageConverter
。 - 请求处理阶段 (读取请求体):
- 获取请求的
Content-Type
。 - 根据
Content-Type
和目标对象类型,选择一个能处理的HttpMessageConverter
。 - 使用该转换器将请求体内容(如JSON/XML)反序列化为Java对象。
- 获取请求的
- 响应处理阶段 (写入响应体):
- 通过内容协商确定响应的
Content-Type
。 - 根据返回对象类型和协商好的
Content-Type
,选择一个能处理的HttpMessageConverter
。 - 使用该转换器将Java对象序列化为响应体内容(如JSON/XML)。
- 通过内容协商确定响应的
这个机制可以让我们开发者专注于业务逻辑,而不用关心数据格式转换的底层细节,大大提高了开发效率和代码的整洁性。如果需要支持新的数据格式,只需要实现并注册一个新的 HttpMessageConverter
即可。
相关文章:
HttpMessageConverter 的作用是什么? 它是如何实现请求体到对象、对象到响应体的自动转换的(特别是 JSON/XML)?
HttpMessageConverter (HTTP 消息转换器) 是 Spring MVC 框架中一个非常核心的组件,它的主要作用是在 HTTP 请求和响应体与 Java 对象之间进行双向转换。 核心作用: 读取请求体 (Request Body) 到 Java 对象: 当 Controller 方法的参数使用 …...

EdgeShard:通过协作边缘计算实现高效的 LLM 推理
(2024-05-23) EdgeShard: Efficient LLM Inference via Collaborative Edge Computing (EdgeShard:通过协作边缘计算实现高效的 LLM 推理) 作者: Mingjin Zhang; Jiannong Cao; Xiaoming Shen; Zeyang Cui;期刊: (发表日期: 2024-05-23)期刊分区:本地链接: Zhang 等 - 2024 …...

火山 RTC 引擎9 ----集成 appkey
一、集成 appkey 1、网易RTC 初始化过程 1)、添加头文件 实现互动直播 - 互动直播 2.0网易云信互动直播产品的基本功能包括音视频通话和连麦直播,当您成功初始化 SDK 之后,您可以简单体验本产品的基本业务流程,例如主播加入房间…...
ArcGIS Pro 3.4 二次开发 - 框架
环境:ArcGIS Pro SDK 3.4 .NET 8 文章目录 框架1 框架1.1 如何在 DockPane 可见或隐藏时订阅和取消订阅事件1.2 执行命令1.3 设置当前工具1.4 激活选项卡1.5 激活/停用状态 - 修改条件1.6 判断应用程序是否繁忙1.7 获取应用程序主窗口1.8 关闭 ArcGIS Pro1.9 获取 …...

Adminer:一个基于Web的轻量级数据库管理工具
Adminer 是一个由单个 PHP 文件实现的免费数据库管理工具,支持 MySQL、MariaDB、PostgreSQL、CockroachDB、SQLite、SQL Server、Oracle、Elasticsearch、SimpleDB、MongoDB、Firebird、Clickhouse 等数据库。 Adminer 支持的主要功能如下: 连接数据库服…...

RK3568下QT实现按钮切换tabWidget
运行效果: 在 Qt 应用程序开发过程中,TabWidget 是一种非常实用的 UI 组件,它能够以选项卡的形式展示多个页面内容,帮助我们有效组织和管理复杂的界面布局。而在实际使用时,常常会有通过按钮点击来切换 TabWidget 页面的需求,本文将通过一个完整的示例,详细介绍如何在 Q…...

2025 OceanBase 开发者大会全议程指南
5 月 17 日,第三届 OceanBase 开发者大会将在广州举办。 我们邀请数据库领军者与AI实践先锋,与开发者一起探讨数据库与 AI 协同创新的技术趋势,面对面交流 OceanBase 在 TP、AP、KV 及 AI 能力上的最新进展,深度体验“打破技术栈…...
GitHub 趋势日报 (2025年05月15日)
本日报由 TrendForge 系统生成 https://trendforge.devlive.org/ 🌐 本日报中的项目描述已自动翻译为中文 📈 今日整体趋势 Top 10 排名项目名称项目描述今日获星总星数语言1TapXWorld/ChinaTextbookPDF教材。⭐ 6685⭐ 15287Roff2xming521/WeClone&…...

day017-磁盘管理-实战
文章目录 1. 硬盘命名规则2. 添加硬盘2.1 查看硬盘名称 3. 硬盘分区3.1 分区命名规则:mbr分区表格式3.2 创建分区:fdisk3.2.1 fdisk -l:查看硬盘及分区信息3.2.2 fdisk /dev/sdc :为该硬盘分区3.2.3 创建扩展分区和逻辑分区3.2.4 保存设置并退…...

【成品设计】STM32和UCOS-II的项目
项目1:《基于STM32和UCOS-II的水质监测系统》 Ps:分为带系统版本和不带系统版本,功能都一样。 功能说明: 1. 单片机主控:STM32F103C8T6单片机作为核心控制。 2. 酸碱度传感器:实时采集当前PH值。 3. 水质…...
当通过PHP在线修改文件数组遇到不能及时生效问题
当你通过PHP在线修改文件中的数组(比如配置文件、缓存文件等)后,发现修改不能及时生效,常见原因和解决办法如下: 1. 缓存未刷新 问题描述:PHP应用通常会对配置、数据等做缓存(如Redis、Memcached、OPcache、文件缓存等),导致你修改了文件但实际运行时还是旧内容。解决…...

Ngrok 配置:实现 Uniapp 前后端项目内网穿透
文章目录 一、下载并安装 ngrok二、配置 ngrok Authtoken三、启动本地 uniapp 项目四、使用 ngrok 暴露本地服务五、通过公网 URL 访问项目六、后端API项目的穿透问题排查 (uni-app 后端 API 示例)交互流程图示 七、ngrok Web 界面 (本地监控)八、停止 ngrok总结 ngrok 是一款…...

鸿蒙ArkUI体验:Hexo博客客户端开发心得
最近部门也在跟进鸿蒙平台的业务开发,自己主要是做 Android 开发,主要使用 Kotlin/Java 语言。,需要对新的开发平台和开发模式进行学习,在业余时间开了个项目练手,做了个基于 Hexo 博客内容开发的App。鸿蒙主要使用Ark…...

鸿蒙NEXT开发动画案例10
1.创建空白项目 2.Page文件夹下面新建Spin.ets文件,代码如下: interface TranslateOffset {x?:numbery?:number } /*** SpinKit动画组件 - SpinTen* author: CSDN-鸿蒙布道师* since: 2025/05/16*/ ComponentV2 export struct SpinTen {Require Para…...
Python 的 os 库常见使用方法(操作目录及文件)
前言: os 模块是 Python 标准库中用于与操作系统交互的核心模块,提供了许多操作文件和目录的功能。以下是常见的使用方法: 1. 目录操作 方法功能说明示例os.getcwd()获取当前工作目录print(os.getcwd())os.chdir(path)切换当前工作目录os.ch…...

【Linux】Linux安装并配置Redis
目录 1.安装 2.启动服务 3.配置 3.1.绑定地址 3.2.保护模式 3.3.持久化选项 3.3.1.RDB 持久化 3.3.2.AOF 持久化 3.3.3.如何选择 1.安装 Redis 可以从默认的 CentOS 软件仓库中安装。运行以下命令来安装 Redis sudo dnf install redis -y 响应如下 2.启动服务 安装完成后&…...

【11408学习记录】考研英语辞职信写作三步法:真题精讲+妙句活用+范文模板
应聘信 英语写作2005年考研英语真题小作文写作思路第一段第二段妙句7 9妙句11补充3补充4 第三段 妙句成文 每日一句词汇第一步:找谓语第二步:断句第三步:简化主句原因状语从句 英语 写作 2005年考研英语真题小作文 Directions: Two m…...
数据库(一):分布式数据库
定义 分布式数据库(Distributed Database) 是指: 数据分布在多个物理位置,但对用户透明,表现为一个统一逻辑数据库的系统。 结构模式(三层模式扩展) 层次作用对应实体用户层提供统一视图&…...
Java并发编程-线程池(三)
文章目录 线程池实现原理addWorker(Runnable firstTask, boolean core)1. 状态检查:校验线程池是否允许添加线程2. 工作线程数调整:CAS保证并发安全3. 初始化变量4. 创建 Worker 对象并获取线程5. 加锁保证线程安全6. 启动工作线程7. 异常处理核心作用 线…...

《黑马前端ajax+node.js+webpack+git教程》(笔记)——node.js教程+webpack教程(nodejs教程)
黑马程序员前端AJAX入门到实战全套教程,包含学前端框架必会的(ajaxnode.jswebpackgit),一套全覆盖 文章目录 Node.js与Webpack-01.Node.js入门定义和作用什么是前端工程化?(离不开node.js)Node.…...

Flink 快速入门
本文涉及到大量的底层原理知识,包括运行机制图解都非常详细,还有一些实战案例,所以导致本篇文章会比较长,内容比较多,由于内容太多,很多目录可能展示不出来,需要去细心的查看,非常适…...
高效管理多后端服务:Nginx 配置与实践指南
在现代的 Web 开发和运维中,一个系统往往由多个后端服务组成,每个服务负责不同的功能模块。例如,一个电商网站可能包括用户服务、订单服务和支付服务,每个服务都运行在独立的服务器或容器中。为了高效地管理这些服务并提供统一的访…...

阻塞队列:线程安全与生产者消费者模型解析
一、阻塞队列 阻塞队列就是基于普通队列做出扩展 1.线程安全的 如果针对一个已经满了的队列进行入队列,此时入队列操作就会阻塞,一直阻塞到队列不满(其他线程出队列元素)之后 如果针对一个已经空了的队列进行出队列,…...

【入门|Docker】基础知识扫盲:什么是 Docker?
文章目录 基础知识扫盲:什么是 Docker?Docker 是什么?Docker 核心组件Docker 与虚拟机的区别Docker 在现代开发中的核心角色Docker 的局限性 基础知识扫盲:什么是 Docker? 最近打算开始系统性地学习与云计算相关的技术…...
如何利用 Java 爬虫获得某书笔记详情:实战指南
在知识分享和学习的领域,许多平台提供了丰富的书籍笔记和学习资源。通过 Java 爬虫技术,我们可以高效地获取这些笔记的详细信息,以便进行进一步的分析和整理。本文将详细介绍如何利用 Java 爬虫获取某书笔记详情,并提供完整的代码…...

【MYSQL】基本查询,表的增删查改
📚 博主的专栏 🐧 Linux | 🖥️ C | 📊 数据结构 | 💡C 算法 | 🅒 C 语言 | 🌐 计算机网络 |🗃️ mysql 摘要:本文详细介绍了MySQL中的CRUD操作(创…...
在嵌入式系统中, 一般链路层断开多久,断开TCP为好
一、典型场景与推荐策略 1. 实时性优先(工业控制、自动化设备) 需求:快速释放资源,避免因等待重传浪费内存或阻塞任务。 策略: 立即断开:在lwip_netif_link_callback中检测到链路断开后直接关闭TCP连接&a…...

Android Studio 日志系统详解
文章目录 一、Android 日志系统基础1. Log 类2. 日志级别 二、Android Studio 中的 Logcat1. 打开 Logcat2. Logcat 界面组成3. 常用 Logcat 命令 三、高级日志技巧1. 自定义日志工具类2. 打印方法调用栈3. 打印长日志4. JSON 和 XML 格式化输出 四、Logcat 高级功能1. 自定义日…...
基于matlab的D2D 功率控制仿真
基于MATLAB的D2D(Device-to-Device)功率控制仿真示例,包含系统建模、功率控制算法实现和性能分析。该仿真以蜂窝网络为背景,重点关注D2D用户间的干扰管理和功率优化。 1. 系统模型与参数设置 clc; clear; close all;%% 参数配置…...
互联网大厂Java面试:从基础到复杂场景的技术挑战
互联网大厂Java面试:从基础到复杂场景的技术挑战 场景描述 在一家知名互联网大厂的会议室里,面试官严肃地坐在桌子的一侧,而对面则是一位充满喜感的应聘者——谢飞机。面试官准备了一系列关于Java技术栈的提问,涵盖了从基础到复…...