SpringBoot响应处理实现流程详解

 更新时间:2022年10月08日 11:25:37   作者:Decade0712  
这篇文章主要介绍了SpringBoot响应处理实现流程,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习吧

1、相关依赖

web项目引入的启动器spring-boot-starter-web中含有

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-json</artifactId>
	<version>2.7.0</version>
	<scope>compile</scope>
</dependency>

这个依赖下面又有jackson的相关依赖,用于json的转换

<dependency>
  <groupId>com.fasterxml.jackson.core</groupId>
  <artifactId>jackson-databind</artifactId>
  <version>2.13.3</version>
  <scope>compile</scope>
</dependency>
<dependency>
  <groupId>com.fasterxml.jackson.datatype</groupId>
  <artifactId>jackson-datatype-jdk8</artifactId>
  <version>2.13.3</version>
  <scope>compile</scope>
</dependency>
<dependency>
  <groupId>com.fasterxml.jackson.datatype</groupId>
  <artifactId>jackson-datatype-jsr310</artifactId>
  <version>2.13.3</version>
  <scope>compile</scope>
</dependency>

2、ReturnValueHandlers—返回值处理器

之前我们分析了参数解析器argumentResolvers的相关源码,了解了请求中的参数是如何找到合适的参数解析器,并与方法的入参进行绑定的,那么问题来了,响应值的返回值处理器是如何找到的呢?

要分析源码,我们还是得进入DispatcherServlet这个类下的doDiapatch()方法

与之前分析参数解析器一样的流程,我们跟到了RequestMappingHandlerAdapter这个类下的invokeHandlerMethod()方法

通过断点可以看到我们默认支持15种返回值解析器

那么他是怎么从这么多返回值解析器中选出自己支持的那一个呢?

我们可以发现,这些返回值解析器都是实现了HandlerMethodReturnValueHandler接口

package org.springframework.web.method.support;
import org.springframework.core.MethodParameter;
import org.springframework.lang.Nullable;
import org.springframework.web.context.request.NativeWebRequest;
public interface HandlerMethodReturnValueHandler {
    boolean supportsReturnType(MethodParameter returnType);
    void handleReturnValue(@Nullable Object returnValue, MethodParameter returnType, ModelAndViewContainer mavContainer, NativeWebRequest webRequest) throws Exception;
}

此接口下只有2个方法,一个是判断是否支持此类型返回值,另一个是处理返回值的方法

是不是和之前的参数解析器的接口类有异曲同工之妙?

没错,我们正是使用这两个方法来寻找适合自己的返回值解析器以及处理我们的返回值

跟着断点一直向下,我们跟到了HandlerMethodReturnValueHandlerComposite类下的handleReturnValue()方法,在这里,我们就找到了对应的解析器并执行了相关方法

public void handleReturnValue(@Nullable Object returnValue, MethodParameter returnType, ModelAndViewContainer mavContainer, NativeWebRequest webRequest) throws Exception {
	// 获取自己适合的返回值解析器
    HandlerMethodReturnValueHandler handler = this.selectHandler(returnValue, returnType);
    if (handler == null) {
        throw new IllegalArgumentException("Unknown return value type: " + returnType.getParameterType().getName());
    } else {
    	// 调用该返回值解析器中的处理返回值的方法
        handler.handleReturnValue(returnValue, returnType, mavContainer, webRequest);
    }
}
@Nullable
private HandlerMethodReturnValueHandler selectHandler(@Nullable Object value, MethodParameter returnType) {
	// 判断是否是异步的返回值
    boolean isAsyncValue = this.isAsyncReturnValue(value, returnType);
    Iterator var4 = this.returnValueHandlers.iterator();
    HandlerMethodReturnValueHandler handler;
    // 使用do-while进行遍历,找出支持当前返回值类型的解析器
    do {
        do {
            if (!var4.hasNext()) {
                return null;
            }

            handler = (HandlerMethodReturnValueHandler)var4.next();
        } while(isAsyncValue && !(handler instanceof AsyncHandlerMethodReturnValueHandler));
    } while(!handler.supportsReturnType(returnType));
    return handler;
}

最终,我们确定使用解析器RequestResponseBodyMethodProcessor可以处理标注了@ResponseBody的返回值

3、HttpMessageConvert—消息转换器

除了寻找合适的返回值解析器之外,我们还有一个问题要思考

为什么我们在控制器类的方法上加一个@ResponseBody注解就能将响应信息转换成json格式呢?

这个转换是怎样实现的呢?

我们接着上面的代码继续往下debug

之前我们已经定位到了使用RequestResponseBodyMethodProcessor来处理@ResponseBody的返回值,所以我们继续深入到这个类下的handleReturnValue()

public void handleReturnValue(@Nullable Object returnValue, MethodParameter returnType, ModelAndViewContainer mavContainer, NativeWebRequest webRequest) throws IOException, HttpMediaTypeNotAcceptableException, HttpMessageNotWritableException {
	mavContainer.setRequestHandled(true);
	// 创建输入和输出信息
	ServletServerHttpRequest inputMessage = this.createInputMessage(webRequest);
	ServletServerHttpResponse outputMessage = this.createOutputMessage(webRequest);
	// 使用消息转换器进行写出操作
	this.writeWithMessageConverters(returnValue, returnType, inputMessage, outputMessage);
}

然后我们来分析解析器父类AbstractMessageConverterMethodProcessor下的writeWithMessageConverters()方法

首先我们了解一个概念:什么是内容协商?

浏览器默认会以请求头的方式告诉服务器他能接受什么样的内容类型,这里的q代表优先级

然后服务器最终根据自己自身的能力,决定服务器能生产出什么样内容类型的数据

所以在writeWithMessageConverters()方法中我们获取到浏览器能接受什么内容

以及服务器能产生什么内容

然后我们经过协商,决定返回application/json格式的数据

重点来了:这里有一系列的消息转换器,我们到底使用哪个呢?

随便点进一个消息转换器,我们发现他都是实现了HttpMessageConverter这个接口

这里面有2个方法,canRead()和canWrite()来帮助我们判断能否支持源类型和目标类型的消息读写

最终我们确定了,使用MappingJackson2HttpMessageConverter这个消息转换器来进行json转换

package org.springframework.http.converter;
import java.io.IOException;
import java.util.Collections;
import java.util.List;
import org.springframework.http.HttpInputMessage;
import org.springframework.http.HttpOutputMessage;
import org.springframework.http.MediaType;
import org.springframework.lang.Nullable;
public interface HttpMessageConverter<T> {
	// 读取,将我们当前消息转换器支持的对象以某种格式读取进来,例如将json数据读取成Person对象
    boolean canRead(Class<?> clazz, @Nullable MediaType mediaType);
	// 写出,我们当前消息转换器支持的对象以某种格式写出去,例如将Person对象以json格式写出去
    boolean canWrite(Class<?> clazz, @Nullable MediaType mediaType);
    List<MediaType> getSupportedMediaTypes();
    default List<MediaType> getSupportedMediaTypes(Class<?> clazz) {
        return !this.canRead(clazz, (MediaType)null) && !this.canWrite(clazz, (MediaType)null) ? Collections.emptyList() : this.getSupportedMediaTypes();
    }
    T read(Class<? extends T> clazz, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException;
    void write(T t, @Nullable MediaType contentType, HttpOutputMessage outputMessage) throws IOException, HttpMessageNotWritableException;
}

然后我们在此处调用MappingJackson2HttpMessageConverter父类AbstractGenericHttpMessageConverter中的write()方法

走到AbstractJackson2HttpMessageConverter类下的writeInternal()方法

可以看出,它利用了底层的Jackson的objectMapper进行转换

这样,我们就完成了Person数据到json格式的转换

大概流程如下

  • 判断当前响应头中是否已经有确定的媒体类型,即MediaType
  • 获取客户端(PostMan、浏览器)支持接收的内容类型(获取客户端Accept请求头字段)
  • 遍历循环所有当前系统的 MessageConverter,看谁支持操作这个对象(Person),找到支持操作Person的converter,把该converter支持的媒体类型统计出来放到集合中,这样就获取到服务端能提供哪些媒体类型
  • 进行内容协商,找到最佳匹配媒体类型
  • 用 支持 将对象转为 最佳匹配媒体类型 的converter,调用它进行转化

4、开启浏览器参数方式内容协商功能

如果需要返回xml格式的数据,那么需要额外导入相关依赖

<dependency>
	<groupId>com.fasterxml.jackson.dataformat</groupId>
	<artifactId>jackson-dataformat-xml</artifactId>
</dependency>

我们可以看到,浏览器是默认支持如下返回格式的,一般情况下,我们无法指定自己需要的返回格式

但是我们可以通过修改配置+添加参数的方式指定我们需要的格式

首先,我们在yaml文件中,开启基于浏览器参数方式内容协商功能

spring:
  mvc:
    contentnegotiation:
      favor-parameter: true

一旦此参数设置为true,那么我们的内容协商管理器contentNegotiationManager中,除了原有的从请求头获取媒体类型的策略之外,还多了一个从请求参数中获取媒体类型的策略,它支持xml和json两种媒体类型

然后我们使用http://localhost:8080/testPathVariable/001/split/decade?format=xml或者http://localhost:8080/testPathVariable/001/split/decade?format=json指定我们需要的返回格式

到此这篇关于SpringBoot响应处理实现流程详解的文章就介绍到这了,更多相关SpringBoot响应处理内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Intellij IDEA调试技巧的深入讲解

    Intellij IDEA调试技巧的深入讲解

    这篇文章主要给大家介绍了关于Intellij IDEA调试技巧的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-08-08
  • Spring Boot详解五种实现跨域的方式

    Spring Boot详解五种实现跨域的方式

    跨域指的是浏览器不能执⾏其他⽹站的脚本。它是由浏览器的同源策略造成的,是浏览器对javascript施加的安全限制,这篇文章主要介绍了springboot实现跨域的5种方式,需要的朋友可以参考下
    2022-06-06
  • 基于mybatis进行批量更新两种方法

    基于mybatis进行批量更新两种方法

    这篇文章主要给大家介绍了关于如何基于mybatis进行批量更新的两种方法,批量更新的使用,mybatis中批量更新有很多种方法,可以把数据一条条更新,也可以传入一个数据集一次性更新,需要的朋友可以参考下
    2023-08-08
  • 为何Java8需要引入新的日期与时间库

    为何Java8需要引入新的日期与时间库

    这篇文章主要给大家介绍了关于Java8为什么需要引入新的日期与时间库的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-11-11
  • Jmeter连接Mysql数据库实现过程详解

    Jmeter连接Mysql数据库实现过程详解

    这篇文章主要介绍了Jmeter连接Mysql数据库实现过程详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-08-08
  • Java经典设计模式之模板方法模式定义与用法示例

    Java经典设计模式之模板方法模式定义与用法示例

    这篇文章主要介绍了Java经典设计模式之模板方法模式,简单说明了模板方法模式的原理、定义,并结合实例形式分析了java模板方法模式的具体使用方法,需要的朋友可以参考下
    2017-08-08
  • Java的Synchronized关键字学习指南(全面 & 详细)

    Java的Synchronized关键字学习指南(全面 & 详细)

    这篇文章主要给大家介绍了关于Java的Synchronized关键字的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-03-03
  • Java 网络爬虫基础知识入门解析

    Java 网络爬虫基础知识入门解析

    这篇文章主要介绍了Java 网络爬虫基础知识入门解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-10-10
  • Springboot启动停止命令的.sh脚本编写方式

    Springboot启动停止命令的.sh脚本编写方式

    这篇文章主要介绍了Springboot启动停止命令的.sh脚本编写方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-05-05
  • 将内容写到txt文档里面并读取及删除的方法

    将内容写到txt文档里面并读取及删除的方法

    本文有个不错的示例,主要讲解如何将内容写到txt文档里面、读取文件里面的内容以及清除txt文件里面的内容
    2014-01-01

最新评论