使用SpringMVC创建REST API(一):使用“协商资源(Content negotiation)”

内容协商(Content negotiation): 选择一个视图,它能够将模型渲染为呈现给客户端的表述形式。

一、协商资源的表述

首先,要配置  ContentNegotiatingViewResolver,这是一个特殊的视图解析器。该解析器工作原理如下:

1. 确定请求的媒体类型;

2. 找到适合请求媒体类型的最佳视图;

1.1 确定请求的媒体类型

默认策略为:

  • 首先,查看URL的文件拓展名。如果URL在结尾处有文件拓展名:拓展名为“.json”,那么所需的内容类型就必须是“application/json” ;拓展名为“.xml”,那么客户端请求的就是“application/xml”;拓展名为“.html”,表明客户端所需的资源表述为HTML(text/html);
  • 如果根据文件拓展名不能得到任何媒体类型的话,那就会考虑请求中的Accept头部信息;
  • 最后,如果没有头部信息,并且拓展名也无法提供帮助的话,ContentNegotiatingViewResolver将会使用“/”作为默认的内容类型,这就意味着客户端必须要接收服务器发送的任何形式的表述

影响媒体类型的选择:通过设置一个ContentNegotiationManager

  • 指定默认的内容类型,如果请求无法得到内容类型的话,将使用默认值;
  • 通过请求参数指定内容类型;
  • 忽视请求的Accept头部信息;
  • 将请求的拓展名映射为特定的媒体类型;
  • 将JAF(Java Activation Framework)作为根据拓展名查找媒体类型的备用方案。

2. 实践案例:

详细的代码在github上:SpringRESTSpittr

2.1 使用默认的请求类型(此处为html)

使用默认请求类型

2.2 使用".json"拓展名

使用json请求类型

2.3 使用“.xml” 拓展名

使用xml类型

猜你喜欢

转载自blog.csdn.net/hefrankeleyn/article/details/89435791