5.2 内容协商
5.2.1 内容协商介绍
根据浏览器可接受的媒体类型,服务器返回不同媒体类型的数据。
服务器会根据优先级,优先匹配浏览器和服务器都支持并且优先级最高的媒体类型。
例如,使用POSTMAN来分别测试响应 Json 和 xml 类型的数据。
-
导入解析 xml 文件类型的依赖 <dependency>
<groupId>com.fasterxml.jackson.dataformat</groupId>
<artifactId>jackson-dataformat-xml</artifactId>
</dependency>
-
设置请求头 Accept=application/xml,则服务器将会响应 xml 类型的数据: -
设置请求头 Accept=application/json,服务器将会响应 json类型的数据: -
设置请求头 Aceept=apllication/json;q=0.8, application/xml;q=0.9 。 服务器将会优先响应权重高的 xml 类型数据:
5.2.2内容协商原理
内容协商的内容在返回值处理器 RequestResponseBodyMethodProcessor->writeWithMessageConverters() 方法中
-
判断当前响应头中是否已经保存了 MediaType,如果有则该 MediaType 作为 selectedMediaType。 -
否则,先获取浏览器可接受的所有MediaType: acceptableTypes。 获取的原理:调用返回值处理器的内容协商管理器来获取到当前请求头中 Accept 字段的值,封装到 List 中,并按权重进行排序。 -
获取支持当前返回值类型的 MessageConverter 所支持的所有 MediaType:producibleTypes。 获取的原理:获取当前处理器中保存的所有 MessageConverter,匹配支持当前返回值类型的 MessageConverter,将这些 MessageConverter 支持的所有 MediaType 返回。 -
对两种类型进行最佳匹配,筛选出所有可以使用的 MediaType:mediaTypesToUse。
-
对 mediaTypesToUse 按权重进行排序,优先选中优先级较高的作为选定的 MediaType:selectedMediaType。 如果匹配到不是具体的 MediaType(带通配符 *),则 selctedMediaType = application/octet-stream -
匹配支持将当前返回值类型 转换为 selectedMediaType 的 MessageConverter,并使用其 write() 方法将当前返回值写入到响应体中。
|