概要


要实现Restful风格,主要有两个方面要讲解,如下:

1. 同一个资源,如果需要返回不同的形式,如:json、xml等;

不推荐的做法:
  • /user/getUserJson
  • /user/getUserXML
这样做不符合Restful的原则,1个资源相当于变成了两个资源;

2. 对同一资源的CRUD操作

不推荐的做法:
  • /user/addUser/
  • /user/getUser/123
  • /user/deleteUser/123
  • /user/updateUser/123
这样做也不符合Restful的原则,1个资源相当于变成了多个资源;

本篇文章将介绍《 同一个资源,如果需要返回不同的形式,如:json、xml等;》如何实现。
至于《对同一资源的CRUD操作》,将留在下一篇文件讲解。


内容协商介绍


RESTful服务中很重要的一个特性即是同一资源,多种表述,也即如下面描述的三种方式:
  • 方式1:使用http request header: Accept
  1. GET /user/123 HTTP/1.1
  2. Accept: application/xml                 //将返回xml格式数据
  3. GET /user/123 HTTP/1.1
  4. Accept: application/json               //将返回json格式数据
  • 方式2:使用扩展名
  1. /user/123.xml  将返回xml格式数据
  2. /user/123.json 将返回json格式数据
  3. /user/123.html 将返回html格式数据

  • 方式3:使用参数
  1. /user/123?format=xml          //将返回xml数据
  2. /user/123?format=json          //将返回json数据

以上三种优缺点比较

  • 使用Accept header   ==>由于浏览器的差异,一般不使用此种方式
 这一种为教科书中通常描述的一种,理想中这种方式也是最好。但由于浏览器的差异,发送上来的Accept Header头是不一样的。 将导致服务器不知要返回什么格式的数据给你。 下面是浏览器的Accept Header
  1. chrome:
  2. Accept:application/xml,application/xhtml+xml,textml;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
  3. firefox:
  4. Accept:text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
  5. IE8:
  6. Accept:image/gif, image/jpeg, image/pjpeg, image/pjpeg, application/x-shockwave-flash, application/x-silverlight, application/x-ms-application, application/x-ms-xbap, application/vnd.ms-xpsdocument, application/xaml+xml, */*

  • 使用扩展名
丧失了同一url多种展现的方式,但现在这种在实际环境中是使用最多的,因为更加直观,方便。
  • 使用参数
现在很多open API是使用这种方式,但因为要编写的字符较多,所以不如“使用扩展名”使用的多。


使用ContentNegotiatingViewResolver内容协商视图解析器


ContentNegotiatingViewResolver可用于实现上述三种方式的Restful的风格,因为使用Accept不是很推荐,所以我们的配置使用了“使用扩展名”和“使用参数”这两种方式。下面直接看下配置吧:

我们在A处配置的是JSON视图对象,而B处配置的是XML视图对象,他们都是默认的候选视图对象,会覆盖对应的视图解析器返回的视图对象。简单的说,就是:
1. 如果资源的URL形如:
  • /user/123.json   或
  • /user/123?format=json
则直接返回A处对应的视图对象,即JSON格式的视图对象;
2. 如果资源的URL形如:
  • /user/123.xml
  • /user/123?format=xml
则直接返回B处对应的视图对象,即XML格式的视图对象;
有一点需要说明,xml解析需要的jar包:
  1. xpp3_min-xxx.jar;
  2. xstream-xxx.jar。

3. 如果资源的URL形如:
  • /user/123.html
  • /user/123?format=html
则由C处对应的InternalResourceViewResolver视图解析器解析;
4. 如果资源的URL不带任何参数,形如:
  • /user/123

则由C处对应的InternalResourceViewResolver视图解析器解析,因为已经默认制定 p:defaultContentType="text/html";


配置文件的完整代码如下:

  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
  4. xmlns:context="http://www.springframework.org/schema/context"
  5. xmlns:mvc="http://www.springframework.org/schema/mvc"
  6. xsi:schemaLocation="http://www.springframework.org/schema/beans
  7. http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
  8. http://www.springframework.org/schema/context
  9. http://www.springframework.org/schema/context/spring-context-3.0.xsd
  10. http://www.springframework.org/schema/mvc
  11. http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd">
  12. <!-- 扫描web包,应用Spring的注解 -->
  13. <context:component-scan base-package="com.ll.web"/>
  14. <mvc:annotation-driven/>
  15. <!-- 协商多种视图解析器 -->
  16. <bean class="org.springframework.web.servlet.view.ContentNegotiatingViewResolver"
  17. p:order="0"
  18. p:ignoreAcceptHeader="true"
  19. p:favorPathExtension="true"
  20. p:favorParameter="true"
  21. p:parameterName="format"
  22. p:defaultContentType="text/html">
  23. <!-- 用来定义哪些扩展名(如:/user/123.json),或协商参数值(如:/user/123?format=xml)是可识别的 -->
  24. <property name="mediaTypes">
  25. <map>
  26. <entry key="html" value="text/html" />
  27. <entry key="xml" value="application/xml" />
  28. <entry key="json" value="application/json" />
  29. </map>
  30. </property>
  31. <property name="defaultViews">
  32. <list>
  33. <!-- for application/json -->
  34. <bean class="org.springframework.web.servlet.view.json.MappingJacksonJsonView"/>
  35. <!-- for application/xml -->
  36. <bean class="org.springframework.web.servlet.view.xml.MarshallingView">
  37. <property name="marshaller">
  38. <bean class="org.springframework.oxm.xstream.XStreamMarshaller"/>
  39. </property>
  40. </bean>
  41. </list>
  42. </property>
  43. </bean>
  44. <!-- Excel及PDF视图解析器配置 -->
  45. <bean class="org.springframework.web.servlet.view.BeanNameViewResolver"
  46. p:order="10" />
  47. <!-- 配置视图解析器,将ModelAndView及字符串解析为具体的页面,默认优先级最低 -->
  48. <bean
  49. class="org.springframework.web.servlet.view.InternalResourceViewResolver"
  50. p:order="100"
  51. p:viewClass="org.springframework.web.servlet.view.JstlView"
  52. p:prefix="/resource/jsp/"
  53. p:suffix=".jsp" />
  54. <!-- spring mvc对静态资源的访问 -->
  55. <mvc:resources mapping="/resource/**" location="/resource/**" />
  56. </beans>


控制层代码





测试


1. json格式





4. 不带任何参数

http://localhost:8080/SpringMVCTest/test/list.xxx  (不是上述提到的后缀名) 或
 http://localhost:8080/SpringMVCTest/test/list?format=xxx  (不是上述提到的后缀名)

 

其他


博客:
  淘宝-代做毕设:


附件列表

【Spring学习笔记-MVC-18.1】Spring MVC实现RESTful风格-同一资源,多种展现:xml-json-html的更多相关文章

  1. 【Spring学习笔记-MVC-15.1】Spring MVC之异常处理=404界面

    作者:ssslinppp       异常处理请参考前篇博客:<[Spring学习笔记-MVC-15]Spring MVC之异常处理>http://www.cnblogs.com/sssl ...

  2. 【Spring学习笔记-MVC-13.2】Spring MVC之多文件上传

    作者:ssslinppp       1. 摘要 前篇文章讲解了单文件上传<[Spring学习笔记-MVC-13]Spring MVC之文件上传>http://www.cnblogs.co ...

  3. 【Spring学习笔记-MVC-5】利用spring MVC框架,实现ajax异步请求以及json数据的返回

    作者:ssslinppp      时间:2015年5月26日 15:32:51 1. 摘要 本文讲解如何利用spring MVC框架,实现ajax异步请求以及json数据的返回. Spring MV ...

  4. Spring学习笔记(一)—— Spring介绍及入门案例

    一.Spring概述 1.1 Spring是什么 Spring是一个开源框架,是于2003年兴起的一个轻量级的Java开发框架, 由Rod Johnson 在其著作<Expert one on ...

  5. Spring学习笔记4—流程(Spring Web Flow)

    Spring Web Flow是Spring框架的子项目,作用是让程序按规定流程运行. 1 安装配置Spring Web Flow 虽然Spring Web Flow是Spring框架的子项目,但它并 ...

  6. Spring学习笔记(二)Spring基础AOP、IOC

    Spring AOP 1. 代理模式 1.1. 静态代理 程序中经常需要为某些动作或事件作下记录,以便在事后检测或作为排错的依据,先看一个简单的例子: import java.util.logging ...

  7. Spring学习笔记(四)-- Spring事务全面分析

    通过本系列的文章对Spring的介绍,我们对Spring的使用和两个核心功能IOC.AOP已经有了初步的了解,结合我个人工作的情况,因为项目是金融系 统.那对事务的控制是不可缺少的.而且是很严格的控制 ...

  8. Spring学习笔记(四)—— Spring中的AOP

    一.AOP概述 AOP(Aspect Oriented Programming),即面向切面编程,可以说是OOP(Object Oriented Programming,面向对象编程)的补充和完善.O ...

  9. spring学习笔记(二)spring中的事件及多线程

    我们知道,在实际开发中为了解耦,或者提高用户体验,都会采用到异步的方式.这里举个简单的例子,在用户注册的sh时候,一般我们都会要求手机验证码验证,邮箱验证,而这都依赖于第三方.这种情况下,我们一般会通 ...

随机推荐

  1. 用python matplotlib 画图

    state-machine environment object-oriente interface figure and axes backend and frontend user interfa ...

  2. 在web.xml中配置error-page

    在web.xml中配置error-page 在web.xml中有两种配置error-page的方法,一是通过错误码来配置,而是通过异常的类型来配置,分别举例如下: 一.   通过错误码来配置error ...

  3. JavaWeb学习记录(二十)——Model1模式(javaBean+jsp)实现简单计算器案例

    ¨JSP技术提供了三个关于JavaBean组件的动作元素,即JSP标签,它们分别为: ¨<jsp:useBean>标签:用于在JSP页面中查找或实例化一个JavaBean组件. ¨< ...

  4. 全国信息学奥林匹克联赛 ( NOIP2014) 复赛 模拟题 Day1 长乐一中

    题目名称 正确答案  序列问题 长途旅行 英文名称 answer sequence travel 输入文件名 answer.in sequence.in travel.in 输出文件名 answer. ...

  5. poj2240 最短路判环

    题意:与poj1680一样,有不同的换钱渠道,可以完成特定两种货币的交换,并且有汇率,只不过此题是单向边,然后问是否能使财富增加 与poj1680一样,建图之后直接spfa判增值的环即可 #inclu ...

  6. Too many authentic authentication failures for root

    连接SSH服务器时报 Too many authentic authentication failures for root. 方法一:删除目标服务器 /root/.ssh/目录下的 known_ho ...

  7. apk反编译生成程序的源代码和图片、XML配置、语言资源等文件

    Android应用的UI越来越漂亮,遇到喜欢的我们可以通过反编译,得到应用的源代码借鉴下别人的思想. 具体步骤: 1.下载 apktool 下载地址:https://code.google.com/p ...

  8. viewPage

    <?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android=&quo ...

  9. Measuring PostgreSQL Checkpoint Statistics

    Checkpoints can be a major drag on write-heavy PostgreSQL installations. The first step toward ident ...

  10. C++ vector和list的区别

    1.vector数据结构vector和数组类似,拥有一段连续的内存空间,并且起始地址不变.因此能高效的进行随机存取,时间复杂度为o(1);但因为内存空间是连续的,所以在进行插入和删除操作时,会造成内存 ...