五.(核心功能）Springboot web 开发阶段（ 4、数据响应与内容协商的原理（通过协商，找到适合匹配的数据格式返回响应

最新推荐文章于 2023-11-03 20:51:17 发布

是小晴晴呀

最新推荐文章于 2023-11-03 20:51:17 发布

阅读量280

点赞数 1

分类专栏： springboot 文章标签： spring boot 前端后端数据响应

原文链接：https://blog.csdn.net/qq_43284469/article/details/112196318

版权

springboot 专栏收录该内容

29 篇文章 0 订阅

订阅专栏

响应数据的内容概述

1、如何响应JSON数据格式

1.1、使用 jackson.jar+ @ResponseBody

分析原理，底层注解

1、返回值解析器

2、返回值解析器原理

1.2、SpringMVC到底支持哪些返回值

1.3、HTTPMessageConverter原理

1、MessageConverter规范（数据信息转换）

2、默认的MessageConverter（上图默认的能够转换什么格式数据）

2、内容协商

1、引入xml依赖

2、postman分别测试返回json和xml

3、开启浏览器参数方式内容协商功能（默认是不开启的）

确定客户端接收什么样的内容类型；

4、内容协商原理

5、如何自定义 MessageConverter

1、如何响应JSON数据格式

1.1、使用 jackson.jar+ @ResponseBody

 <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
web场景自动引入了json场景
    <dependency>   这是自动引入的，原来封装好的
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-json</artifactId>
      <version>2.3.4.RELEASE</version>
      <scope>compile</scope>
    </dependency>

测试

给前端自动返回json数据；

分析原理，底层注解

1、返回值解析器

try {
            this.returnValueHandlers.handleReturnValue(
                  returnValue, getReturnValueType(returnValue), mavContainer, webRequest);
        }
利用返回值处理器（能处理返回的数据），经行数据返回的转换

2、返回值解析器原理

1、返回值处理器判断是否支持这种类型返回值 supportsReturnType
2、返回值处理器调用 handleReturnValue 进行处理

3、RequestResponseBodyMethodProcessor 可以处理返回值标了@ResponseBody 注解的。

1. 利用 MessageConverters 进行处理将数据写为json

1、内容协商（浏览器默认会以请求头的方式告诉服务器他能接受什么样的内容类型）
2、服务器最终根据自己自身的能力，决定服务器能生产出什么样内容类型的数据，

3、SpringMVC会挨个遍历所有容器底层的 HttpMessageConverter ，看谁能处理？

1、得到MappingJackson2HttpMessageConverter可以将对象写为json
2、利用MappingJackson2HttpMessageConverter将对象转为json再写出去。

@Override
	public void handleReturnValue(@Nullable Object returnValue, MethodParameter returnType,  这个函数就是返回值处理器
	ModelAndViewContainer mavContainer, NativeWebRequest webRequest) throws Exception {   参数是不同的

		HandlerMethodReturnValueHandler handler = selectHandler(returnValue, returnType);
		if (handler == null) {
			throw new IllegalArgumentException("Unknown return value type: " + returnType.getParameterType().getName());
		}
		handler.handleReturnValue(returnValue, returnType, mavContainer, webRequest);
	}

ReuestResponseBodyMethodProcessor  	
@Override
	public void handleReturnValue(@Nullable Object returnValue, MethodParameter returnType,
			ModelAndViewContainer mavContainer, NativeWebRequest webRequest)
			throws IOException, HttpMediaTypeNotAcceptableException, HttpMessageNotWritableException {

		mavContainer.setRequestHandled(true);
		ServletServerHttpRequest inputMessage = createInputMessage(webRequest);
		ServletServerHttpResponse outputMessage = createOutputMessage(webRequest);

		// Try even with null return value. ResponseBodyAdvice could get involved.
        // 使用消息转换器进行写出操作
		writeWithMessageConverters(returnValue, returnType, inputMessage, outputMessage);
	}    //这是把处理的结果返回上一层，得到了这次匹配的返回值类型

浏览器中，请求头中的默认请求

1.2、SpringMVC到底支持哪些返回值

ModelAndView   //容器中支持的数据类型
Model
View
ResponseEntity 
ResponseBodyEmitter
StreamingResponseBody
HttpEntity
HttpHeaders
Callable
DeferredResult
ListenableFuture
CompletionStage
WebAsyncTask
有 @ModelAttribute 且为对象类型的
@ResponseBody 注解 ---> RequestResponseBodyMethodProcessor；

1.3、HTTPMessageConverter原理

1、MessageConverter规范（数据信息转换）

HttpMessageConverter: 看是否支持将此 Class类型的对象，转为MediaType类型的数据。

例子：Person对象转为JSON。或者 JSON转为Person

2、默认的MessageConverter（上图默认的能够转换什么格式数据）

0 - 只支持Byte类型的

1 - String

2 - String

3 - Resource

4 - ResourceRegion

5 - DOMSource.class \ SAXSource.class) \ StAXSource.class \StreamSource.class \Source.class

6 - MultiValueMap

7 - true

8 - true

9 - 支持注解方式xml处理的。

最终 MappingJackson2HttpMessageConverter 把对象转为JSON（利用底层的jackson的objectMapper转换的）

2、内容协商

根据客户端接收能力不同，返回不同媒体类型的数据。

1、引入xml依赖

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

2、postman分别测试返回json和xml

只需要改变请求头中Accept字段。Http协议中规定的，告诉服务器本客户端可以接收的数据类型。

3、开启浏览器参数方式内容协商功能（默认是不开启的）

为了方便内容协商，开启基于请求参数的内容协商功能。

spring:
    contentnegotiation:
      favor-parameter: true  #开启请求参数内容协商模式

发请求： http://localhost:8080/test/person?format=json

http://localhost:8080/test/person?format=xml 开启之后的访问地址格式后面是数据格式

确定客户端接收什么样的内容类型；

1、Parameter策略优先确定是要返回json数据（获取请求头中的format的值）

2、最终进行内容协商返回给客户端json即可。

4、内容协商原理

1、判断当前响应头中是否已经有确定的媒体类型。MediaType
2、获取客户端（PostMan、浏览器）支持接收的内容类型。（获取客户端Accept请求头字段）【application/xml】

- contentNegotiationManager 内容协商管理器默认使用基于请求头的策略

- HeaderContentNegotiationStrategy 确定客户端可以接收的内容类型

3、遍历循环所有当前系统的 MessageConverter，看谁支持操作这个对象（Person）
4、找到支持操作Person的converter，把converter支持的媒体类型统计出来。

5、客户端需要【application/xml】。服务端能力【10种、json、xml】

6、进行内容协商的最佳匹配媒体类型
7、用支持将对象转为最佳匹配媒体类型的converter。调用它进行转化。

导入了jackson处理xml的包，xml的converter就会自动进来

WebMvcConfigurationSupport 重要的
jackson2XmlPresent = ClassUtils.isPresent("com.fasterxml.jackson.dataformat.xml.XmlMapper", classLoader);

if (jackson2XmlPresent) {
			Jackson2ObjectMapperBuilder builder = Jackson2ObjectMapperBuilder.xml();
			if (this.applicationContext != null) {
				builder.applicationContext(this.applicationContext);
			}
			messageConverters.add(new MappingJackson2XmlHttpMessageConverter(builder.build()));
		}

5、如何自定义 MessageConverter

实现多协议数据兼容。json、xml、x-guigu（自定义数据格式）

0、@ResponseBody 响应数据出去调用 RequestResponseBodyMethodProcessor 处理

1、Processor 处理方法返回值。通过 MessageConverter 处理

2、所有 MessageConverter 合起来可以支持各种媒体类型数据的操作（读、写）

3、内容协商找到最终的 messageConverter；（所以自己在配置类中写入这些函数）

SpringMVC的什么功能。一个入口给容器中添加一个 WebMvcConfigurer

 
@Bean  //自定义添加这个数据解析
    public WebMvcConfigurer webMvcConfigurer(){
        return new WebMvcConfigurer() {

            @Override
            public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {    里面添加  }    }  }