@RestController 返回数据格式 总结

以下总结基于本人手敲实验结论,如有不对,欢迎留言讨论指正

本文以application/xml,application/json两种数据格式为例说明

以下两点为基础

1.前端请求Header的Accept参数指定返回数据格式(最明确的优先匹配)   

当你有如下Accept头:

①Accept:text/html,application/xml,application/json

      将按照如下顺序进行produces的匹配 ①text/html ②application/xml ③application/json

②Accept:application/xml;q=0.5,application/json;q=0.9,text/html

      将按照如下顺序进行produces的匹配 ①text/html ②application/json ③application/xml

      q参数为媒体类型的质量因子,越大则优先权越高(从0到1)

③Accept:*/*,text/*,text/html

      将按照如下顺序进行produces的匹配 ①text/html ②text/* ③*/*

即匹配规则为:最明确的优先匹配

 

2.后端RequestMapping(包括PostMapping,GetMapping等)的produces参数对数据格式进行限制(参数值的顺序决定了优先级)

 

总结:

① 期望数据格式的依赖包必须齐全,不齐全将发生406错误;

JSON是:


    com.fasterxml.jackson.core
    jackson-databind
    2.6.0

XML是:


    com.fasterxml.jackson.dataformat
    jackson-dataformat-xml
    2.6.0

② 基础1和基础2不兼容(没有重合的目标),返回的数据格式照基础1,发生406错误,如下图情况

@RestController 返回数据格式 总结_第1张图片

@RestController 返回数据格式 总结_第2张图片

③ 基础1和基础2多个目标重合,由基础1的匹配规则决定

④ 基础1缺省,由基础2的参数值顺序决定

⑤ 基础1基础2都缺省,依赖包都齐全的情况下(单一依赖包没测),数据格式由List>的转换器顺序决定,谁在前面就转成谁;转换器顺序可以通过手动注入调整,在不手动注入的情况下,MappingJackson2HttpMessageConverter在前,所以,在完全缺省又没有手动注入转换器的情况下,默认转成json

 

匹配规则引用:https://blog.csdn.net/lzwglory/article/details/17252099

在此对作者表示感谢~

 

 

你可能感兴趣的:(学习笔记,Java基础)