1、什么是消息转换器?

@RequestBody 和 @ResponseBody 两个注解,分别完成请求报文到对象和对象到响应报文的转换。

底层这种灵活的消息转换机制,就是 Spring3.x 中新引入的 HttpMessageConverter,即消息转换器机制。

而负责这种机制的主要接口HttpMessageConverter及其各种子类(StringHttpMessageConverter等),就是消息转换器。

2、消息转换器结构:HttpMessageConverter

消息转换器的结构如下图

  • HttpInputMessage 这个接口是 SpringMVC 内部对一次 Http 请求报文的抽象
  • HttpOutputMessage 这个接口是 SpringMVC 内部对一次 Http 响应报文的抽象
  • HttpMessageConverter 这个接口对消息转换器最高层次的接口抽象
  • 其read()方法接收 HttpInputMessage 作为入参,负责读取请求报文
    • canRead()方法负责判断请求报文是否可以由该消息转换器处理
  • 其 write()方法接收 HttpOutputMessage 作为入参,负责将数据写入响应报文
    • canWrite()方法负责判断响应报文是否可以由该消息转换器处理

接口说明见图:

请求处理流程见图:

3、Spring 调用逻辑

3.1 HandlerMethodArgumentResolver 接口 和 HandlerMethodReturnValueHandler 接口

这两个接口只是声明,定义一些方法。具体的实现才是最终处理。

  • HandlerMethodArgumentResolver 是将请求报文绑定到处理方法形参的策略接口
  • HandlerMethodReturnValueHandler 是对处理方法返回值进行处理的策略接口。

3.2 RequestResponseBodyMethodProcessor 类

  • 该类同时实现了HandlerMethodArgumentResolver 接口 和 HandlerMethodReturnValueHandler 接口。所以充当了方法参数解析和返回值处理两种角色 。

3.2.1 对 HandlerMethodArgumentResolver 接口的实现 ( resolveArgument()方法)

  • 实现可以见源码,这里只说明观看逻辑。

    • 依次进入:resolveArgument()方法→readWithMessageConverters()方法→super.readWithMessageConverters()方法
    • 然后可以看到先调用HttpMessageConverter的canRead()方法,校验通过后调用read()方法。

3.2.2 对 HandlerMethodReturnValueHandler 接口的实现 ( handleReturnValue()方法)

  • 实现可以见源码,这里只说明观看逻辑。

    • 依次进入:handleReturnValue()方法→writeWithMessageConverters()方法[参数不同]→writeWithMessageConverters()方法[参数不同]
    • 然后可以看到先调用HttpMessageConverter的canWrite()方法,校验通过后调用write()方法。

4、HttpMessageConverter子类及其在SpringMVC中的使用

以我们代码中的一个配置作为说明,并具体理解这个加载过程:

<mvc:annotation-driven>
<mvc:message-converters>
<ref bean="fastJsonHttpMessageConverter"/>
<ref bean="sourceHttpMessageConverter"/>
</mvc:message-converters>
</mvc:annotation-driven> <bean id="sourceHttpMessageConverter"
class="org.springframework.http.converter.xml.SourceHttpMessageConverter">
<property name="supportedMediaTypes">
<list>
<value>application/xml;charset=UTF-8</value>
<value>text/xml;charset=UTF-8</value>
</list>
</property>
</bean> <bean id="fastJsonHttpMessageConverter"
class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter">
<property name="supportedMediaTypes">
<list>
<value>text/plain;charset=UTF-8</value>
<value>application/json;charset=UTF-8</value>
</list>
</property>
</bean>

4.1 注解的解析(注解控制器)及加载HttpMessageConverter

主要参考文章: SpringMVC关于json、xml自动转换的原理研究-附带源码分析 - format丶 - 博客园

对于注解的解析:<mvc:annotation-driven/>。该解析由类org.springframework.web.servlet.config.AnnotationDrivenBeanDefinitionParserparse()方法处理。

  • 源码路径:AnnotationDrivenBeanDefinitionParser类→parse()方法→getMessageConverters()方法。

    • 源码中可知,如果没有配置<mvc:message-converters>属性,则加载默认的HttpMessageConverter。

      • 默认的有4个基础的,和5个需要条件再加载的。(这部分不做说明,不属于本文内容)
    • 如果配置了,则只加载配置的HttpMessageConverter

如同上述配置,则只会加载两个sourceHttpMessageConverterfastJsonHttpMessageConverter

4.2 HttpMessageConverter的supportedMediaTypes属性作用

我们配置了多个HttpMessageConverter,而每个HttpMessageConverter可以处理哪些类型的请求则由supportedMediaTypes属性定义(不止该属性,但也是一部分)

这部分的具体使用在:

  • 读部分参考【3.2.1】,找到canRead方法的调用地方之后,我们看canRead方法的实现。

    • 以FastJsonHttpMessageConverter为例,它的canRead方法实现实际调用的时父类(AbstractHttpMessageConverter)的canRead方法实现

      • 父类的实现如下,可以看到有对supportedMediaType的过滤

至此,我们可以确定,XML的配置中的supportedMediaTypes会音响该消息转换器可以处理的请求。以上述配置为例,sourceHttpMessageConverter负责处理XML数据格式的请求;fastJsonHttpMessageConverter处理json格式的请求。

canWrite方法也会用到supportedMediaTypes,可以自行梳理。至此,消息转换器的配置以及生效过程就比较清晰了。

5、参考:

  1. SpringMVC 源码剖析(五)- 消息转换器 HttpMessageConverter - 相见欢的个人空间 - OSCHINA

    注:本篇博客就是该文章的翻版,所以原文很重要。
  2. SpringMVC关于json、xml自动转换的原理研究-附带源码分析 - format丶 - 博客园

    注:对配置的生效过程说明很详细,可以参考。
  3. Spring MVC 解读—— - Don't worry, Loser. - OSCHINA

    注:对于Spring XML配置的解析说明很清楚。重点: 标签解析都是由BeanDefinitionParser接口的子类来完成的。还有对于AnnotationDrivenBeanDefinitionParser 的详细解析。
  4. springMVC的消息转换器(Message Converter) - 简书

    注:对于自定义消息转换器说明很棒,源码说明也不错。
  5. SpringMVC HttpMessageConverter 匹配规则 - - SegmentFault 思否

    注:匹配规则,很深奥看不懂的感觉,后续再看。

Spring 消息转换器和注解控制器的更多相关文章

  1. ActiveMQ之spring集成消息转换器MessageConverter

    MessageConverter的作用主要有两方面,一方面它可以把我们的非标准化Message对象转换成我们的目标Message对象,这主要是用在发送消息的时候:另一方面它又可以把我们的Message ...

  2. 【spring-boot神器】第一篇:拦截器,过滤器,监听器,控制器,消息转换器,AOP执行顺序

    整理一下这几天学习的资料和代码 第一部分.上代码 1.spring各种器的实现,idea搭建spring-boot的教程在这里http://www.jianshu.com/p/9082a533fa3c ...

  3. SpringMVC源码剖析5:消息转换器HttpMessageConverter与@ResponseBody注解

    转自 SpringMVC关于json.xml自动转换的原理研究[附带源码分析] 本系列文章首发于我的个人博客:https://h2pl.github.io/ 欢迎阅览我的CSDN专栏:Spring源码 ...

  4. HandlerMethodArgumentResolver(三):基于消息转换器的参数处理器【享学Spring MVC】

    每篇一句 一个事实是:对于大多数技术,了解只需要一天,简单搞起来只需要一周.入门可能只需要一个月 前言 通过 前面两篇文章 的介绍,相信你对HandlerMethodArgumentResolver了 ...

  5. Spring Boot项目中如何定制HTTP消息转换器

    在构建RESTful数据服务过程中,我们定义了controller.repositories,并用一些注解修饰它们,但是到现在为止我们还没执行过对象的转换--将java实体对象转换成HTTP的数据输出 ...

  6. 【Spring学习笔记-MVC-1.3】消息转换器HttpMessageConverter

    作者:ssslinppp       参考链接: SpringMVC源码剖析(五)-消息转换器HttpMessageConverter: http://my.oschina.net/lichhao/b ...

  7. Spring消息之STOMP

    一.STOMP 简介 直接使用WebSocket(或SockJS)就很类似于使用TCP套接字来编写Web应用.因为没有高层级的线路协议(wire protocol),因此就需要我们定义应用之间所发送消 ...

  8. HttpMessageConverter(消息转换器 )和@responsebody使用(转)

    @responsebody表示该方法的返回结果直接写入HTTP response body中 一般在异步获取数据时使用,在使用@RequestMapping后,返回值通常解析为跳转路径,加上@resp ...

  9. Spring RESTful + Redis全注解实现恶意登录保护机制

    好久没更博了... 最近看了个真正全注解实现的 SpringMVC 博客,感觉很不错,终于可以彻底丢弃 web.xml 了.其实这玩意也是老东西了,丢弃 web.xml,是基于 5.6年前发布的 Se ...

随机推荐

  1. orm-配置不启动项目自动查询orm

    配置 #!/usr/bin/env python import os import sys if __name__ == "__main__": os.environ.setdef ...

  2. shell编程题(一)

    求2个数之和 #!/bin/bash function add { )); then echo "The arg in't correct" else +$)) echo $sum ...

  3. vuex(用了vue就上了一条不归路的贼船)

    一.Vuex是干什么用的? 它是用于对复杂应用进行状态管理用的(官方说法是它是一种状态管理模式). “杀鸡不用宰牛刀”.对于简单的项目,根本用不着Vuex这把“宰牛刀”.那简单的项目用什么呢?用Vue ...

  4. java连数据库和数据库连接池踩坑日记(一)-------oracle连接的一些问题

    最近接触oracle有点多,同时也在配置数据库连接池,坑也就踩多了,记录下. 事情还没有结束,没时间记录问题,很多事情都忘了,过了国庆再写的话可能就真的全忘了吧……而且不单单是数据库问题,还有一些数据 ...

  5. SpringData :下划线的那些破事

    今天写一个查询语句的时候,报错如下 org.springframework.beans.factory.BeanCreationException: Error creating bean with ...

  6. java sqlite docker,sqlite出错

    1问题1 使用docker镜像部署springboot程序,sqlite出错,在windows和linux环境都没有问题,使用docker部署就报错 Caused by: java.lang.Unsa ...

  7. MyBatis项目配置案例详解与Web下的增删改查实现[附项目源码]

    MyBatis项目案例 项目图示: 项目源码地址:https://github.com/JluTiger/mybatispro 1.项目功能 项目案例:后台管理系统用户数据维护平台 所有用户数据查询 ...

  8. python实用技巧之任务切分

    Python 大任务切分小任务 今天来说说,Python中的任务切分.以爬虫为例,从一个存 url 的 txt 文件中,读取其内容,我们会获取一个 url 列表.我们把这一个 url 列表称为大任务. ...

  9. laravel删除文件

    laravel删除文件 一.总结 一句话总结: 1.注意disk:disk决定路径 2.删单个文件的时候就用删单个文件的方式,别用删多个文件的方式(也就是参数别数组) public function ...

  10. [Web前端] mac chrome 浏览器强制刷新,清除浏览器缓存

    本文链接:https://blog.csdn.net/zeroyulong/article/details/79806156 mac 强制刷新:command+shift+r mac 普通刷新:com ...