springMVC笔记系列(7)——HiddenHttpMethodFilter过滤器

什么是REST？首先来段介绍吧。

REST： 即 Representational State Transfer。 （资源）表现层状态转化。 是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、 扩展方便，所以正得到越来越多网站的采用。

资源（Resources） ： 网络上的一个实体，或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务， 总之就是一个具体的存在。可以用一个URI（统一资源定位符）指向它， 每种资源对应一个特定的 URI 。 要获取这个资源， 访问它的URI就可以， 因此 URI 即为每一个资源的独一无二的识别符。

表现层（Representation） ： 把资源具体呈现出来的形式，叫做它的表现层（Representation） 。比如，文本可以用 txt 格式表现，也可以用 HTML 格式、 XML 格式、 JSON 格式表现，甚至可以采用二进制格式。

状态转化（State Transfer） ： 每发出一个请求， 就代表了客户 端和服务器的一次交互过程。 HTTP协议，是一个无状态协议，即所有的状态都保存在服务器端。因此， 如果客户端想要操作服务器，必须通过某种手段， 让服务器端发生“

状态转化”（State Transfer）。而这种转化是建立在表现层之上的，所以就是 “表现层状态转化”。 具体说， 就是 HTTP 协议里面，四个表示操作方式的动词： GET、 POST、 PUT、 DELETE。它们分别对应四种基本操作： GET 用来获取资源， POST 用来新建资源， PUT 用来更新资源， DELETE 用来删除资源。（本文出自：http://my.oschina.net/happyBKs/blog/416994）

示例：

– /order/1    HTTP  GET ： 得到 id =  1 的 order   

– /order/1    HTTP  DELETE： 删除 id = 1 的 order   

– /order/1    HTTP  PUT：更新id = 1 的 order   

– /order      HTTP  POST：新增 order

但是要用spring实现四个方法需要一个过滤器：

HiddenHttpMethodFilter： 浏览器 form 表单只支持 GET与 POST 请求，而DELETE、 PUT 等 method 并不支持， Spring3.0 添加了一个过滤器，可以将这些请求转换为标准的 http 方法，使得支持 GET、 POST、 PUT 与DELETE 请求。

带占位符的 URL 是 Spring3.0 新增的功能， 该功能在SpringMVC 向 REST 目 标挺进发展过程中具有里程碑的意义。

通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中： URL 中的 {xxx} 占位符可以通过@PathVariable("xxx") 绑定到操作方法的入参中。

好吧，话不多说，我们实际操练一下，在webapp目录下的原web.xml中添加HiddenHttpMethodFilter过滤器

1<!DOCTYPE web-app PUBLIC
2 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
3 "http://java.sun.com/dtd/web-app_2_3.dtd" >
4
5<web-app>
6  <display-name>Archetype Created Web Application</display-name>
7  
8  
9  <!-- 配置 org.springframework.web.filter.HiddenHttpMethodFilter，可以吧POST请求转换为PUT或DELETE请求-->
10	<filter>
11		<filter-name>HiddenHttpMethodFilter</filter-name>
12		<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
13	</filter>
14
15	<filter-mapping>
16		<filter-name>HiddenHttpMethodFilter</filter-name>
17		<url-pattern>/*</url-pattern>
18	</filter-mapping>
19  
20  
21  
22  
23  <!--  配置DispatcherServlet -->
24  <!-- 下面的代码为STS自动生成，如果是一般的eclipse需要安装springIDE插件 -->
25  <!-- The front controller of this Spring Web application, responsible for handling all application requests -->
26	<servlet>
27		<servlet-name>springDispatcherServlet</servlet-name>
28		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
29		<!-- 配置DispatcherServlet的一个初始化参数：配置springmvc 配置位置和名称 -->
30		<init-param>
31			<param-name>contextConfigLocation</param-name>
32			<param-value>classpath:springmvc.xml</param-value><!-- classpath下的springmvc.xml -->
33		</init-param>
34		<!-- load-on-startup是指这个servlet是在当前web应用被加载的时候就被创建，而不是第一次被请求的时候被创建 -->
35		<load-on-startup>1</load-on-startup>
36	</servlet>
37
38<!-- 	Map all requests to the DispatcherServlet for handling
39	/代表可以应答所有请求,由springDispatcherServlet处理 -->
40	<servlet-mapping>
41		<servlet-name>springDispatcherServlet</servlet-name>
42		<url-pattern>/</url-pattern>
43	</servlet-mapping>
44</web-app>

springMVC.xml与之前的文章中的例子相比，没有变化，这里为了读者方便也一起给出，关于springMVC的项目结构和配置请参照我之前的文章。

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"
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 http://www.springframework.org/schema/beans/spring-beans.xsd
7		http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.1.xsd
8		http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.1.xsd">
9
10<!-- 配置自动扫描的包 -->
11<context:component-scan base-package="com.happyBKs.springmvc.handlers"></context:component-scan>
12
13<!-- 配置视图解析器：如何把handler方法 的返回值 解析为 实际的物理视图-->
14<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
15<property name="prefix" value="/views/"></property>
16<property name="suffix" value=".jsp"></property>
17</bean>
18
19
20</beans>

接下来写控制器类及其方法，来负责接收和处理请求：RestTestHandler类

1package com.happyBKs.springmvc.handlers;
2
3import org.springframework.stereotype.Controller;
4import org.springframework.web.bind.annotation.PathVariable;
5import org.springframework.web.bind.annotation.RequestMapping;
6import org.springframework.web.bind.annotation.RequestMethod;
7
8@RequestMapping("/rest")
9@Controller
10public class RestTestHandler {
11	
12	/*
13	 * Rest 风格的Url        原先利用请求参数的风格
14	 * 以CRUD为例
15	 * 新增： /order POST		
16	 * 修改：/order/1 Put 		update?id=1
17	 * 获取：/order/1 GET 		get?id=1
18	 * 删除：/order/1 DELETE		delete?id=1
19	 * 
20	 * 如何发送PUT请求和DELETE请求？
21	 * 1.需要配置HiddenHttpMethodFilter
22	 * 2.需要发送POST请求
23	 * 3.需要在发送POST请求时携带一个name=”_method“的隐藏域，值为DELETE或PUT
24	 *	
25	 * 在SpringMVC的目标方法中如何得到id呢？
26	 * 使用@PathVariable注解
27	 */
28	
29	
30	@RequestMapping(value="/methodstest/{id}",method=RequestMethod.GET)
31	public String restGet(@PathVariable int id)//当@PathVariable没有标明{id}，
32	{
33		System.out.println("get "+id);
34		System.out.println("querry operations...");
35		return "querry";
36	}
37	
38	@RequestMapping(value="/methodstest",method=RequestMethod.POST)
39	public String restPost()
40	{
41		System.out.println("post ");
42		System.out.println("post operations...");
43		return "post";
44	}
45	
46	@RequestMapping(value="/methodstest/{id}",method=RequestMethod.PUT)
47	public String restPut(@PathVariable int id)
48	{
49		System.out.println("put "+id);
50		System.out.println("put operations...");
51		return "put";
52	}
53	
54	@RequestMapping(value="/methodstest/{id}",method=RequestMethod.DELETE)
55	public String restDelete(@PathVariable int id)
56	{
57		System.out.println("delete "+id);
58		System.out.println("delete operations...");
59		return "delete";
60	}
61}

请求页面编写如下：

1<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
2    pageEncoding="ISO-8859-1"%>
3<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
4<html>
5<head>
6<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
7<title>Insert title here</title>
8</head>
9<body>
10	<a href="rest/methodstest/1">GET Request</a>
11
12	<form action="rest/methodstest" method="post">
13		<input type="submit" value="POST Request" />
14	</form>
15
16	<form action="rest/methodstest/1" method="post">
17		<input type="hidden" name="_method" value="PUT">
18		<input type="submit" value="PUT Request" />
19	</form>
20
21	<form action="rest/methodstest/1" method="post">
22		<input type="hidden" name="_method" value="DELETE">
23		<input type="submit" value="DELETE Request" />
24	</form>
25</body>
26</html>

注意到了吗？HiddenHttpMethodFilter帮助我们实现对put请求和delete请求的模拟。它会将带有隐藏域_method的POST请求转换为put请求和delete请求提交给服务器。

过程：

点击四个链接和表单按钮：

控制台输入为：

1get 1
2querry operations...
3post 
4post operations...
5put 1
6put operations...
7delete 1
8delete operations...

总结：

 Rest 风格的Url        原先利用请求参数的风格

* 以CRUD为例

* 新增： /order POST

* 修改：/order/1 Put update?id=1

* 获取：/order/1 GET get?id=1

* 删除：/order/1 DELETEdelete?id=1

* 如何发送PUT请求和DELETE请求？

 1.需要配置HiddenHttpMethodFilter

 2.需要发送POST请求

 3.需要在发送POST请求时携带一个name=”_method“的隐藏域，值为DELETE或PUT

* 在SpringMVC的目标方法中如何得到id呢？

 使用@PathVariable注解

——————————————————————————————

注意：我用的是Tomcat7服务器。tomcat8似乎不支持PUT和DELETE请求，即使我已经在Tomcat的conf文件夹下的web.xml加入了readonly参数并设置为false，依然不能解决问题。

1    <servlet>
2        <servlet-name>default</servlet-name>
3        <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
4        <init-param>
5            <param-name>debug</param-name>
6            <param-value>0</param-value>
7        </init-param>
8		
9		<init-param> 
10			<param-name>readonly</param-name> 
11			<param-value>false</param-value> 
12		</init-param> 
13		
14        <init-param>
15            <param-name>listings</param-name>
16            <param-value>false</param-value>
17        </init-param>
18        <load-on-startup>1</load-on-startup>
19    </servlet>

点击post请求和delete请求的结果是：