springmvc笔记（3）—使用@RequestMapping映射请求

一. 能够修饰类

RequestMapping既能够修饰方法，也能够修饰类

 

二. 请求方式

1. @RequestMapping不只能够根据url来响应用户请求，还能够根据其余参数来响应：

• value——请求url
• method——请求方法（post或者get）
• params——请求参数
• headers——请求头

他们之间是”与“的关系，联合使用多个条件可让请求映射更加精确化

eg. （经常使用）使用 method 属性来指定请求方式（params 和 headers 比较不经常使用）

/**
	 * 经常使用: 使用 method 属性来指定请求方式
	 */
	@RequestMapping(value = "/testMethod", method = RequestMethod.POST)
	public String testMethod() {
		System.out.println("testMethod");
		return SUCCESS;
	}

2. params和headers支持简单的表达式：

使用params和headers来精确映射请求（了解便可）：

如上图，要求请求中包含参数“username”和“age”，而且age不等于10；同时要求请求头中的信息中包含“Accept-Language-US,zh;q=0.8”

因此，当请求为以下时，请求没法响应而会报错。

 

三. Ant路径（了解）

• Ant  风格资源地址支持 3 种匹配符

          ?：匹配文件名中的一个字符

          *：匹配文件名中的任意字符 

          **：匹配多层路径 

• @RequestMapping 还支持 Ant  风格的 URL 

           - /user/*/createUser：匹配 /user/aaa/createUser、/user/bbb/createUser 等 URL
           - /user/**/createUser：匹配 /user/createUser、/user/aaa/bbb/createUser 等 URL
           - /user/createUser??： 匹配 /user/createUseraa、/user/createUserbb 等 URL

 

四. @PathVariable注解

带占位符的 URL 是spring3.0 新增的功能，该功能在springmvc向 REST 目标挺进发展过程当中具备里程碑式的意义 

经过 @PathVariable 注解能够将 URL 中的占位符参数绑定到到目标方法的入参中，即：

URL 中的 {xxx}  占位符能够经过@PathVariable（“xxx”）绑定到操做方法的入参中

/**
	 * @PathVariable 能够来映射 URL 中的占位符到目标方法的参数中.
	 * @param id
	 * @return
	 */
	@RequestMapping("/testPathVariable/{id}")
	public String testPathVariable(@PathVariable("id") Integer id) {
		System.out.println("testPathVariable: " + id);
		return SUCCESS;
	}

 

五. HiddenHttpMethodFilter 过滤器

讲 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 用来删除资源。

四种状态分别对应了数据库的增删改查操做，例如：
– /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

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

具体应用步骤：

1. 首先在web.xml中添加HiddenHttpMethodFilter的配置：

<!-- 
	配置 org.springframework.web.filter.HiddenHttpMethodFilter: 能够把 POST 请求转为 DELETE 或 POST 请求 
	-->
	<filter>
		<filter-name>HiddenHttpMethodFilter</filter-name>
		<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
	</filter>
	
	<filter-mapping>
		<filter-name>HiddenHttpMethodFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

2. 请求连接：

<a href="springmvc/testREST/1">test REST GET</a>
<br><br>

<form action="springmvc/testREST" method="post">
	<input type="submit" value="test REST POST">
</form>

<br><br>

<form action="springmvc/testREST/1" method="post">
	<input type="hidden" name="_method" value="DELETE">
	<input type="submit" value="test REST DELETE">
</form>

<br><br>

<form action="springmvc/testREST/1" method="post">
	<input type="hidden" name="_method" value="PUT">
	<input type="submit" value="test REST PUT">
</form>

3. handler处理：

package com.springmvc.handlers;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
@RequestMapping("/springmvc")
public class SpringMVCTest {

	private static final String SUCCESS="success";
	/**
	 * Rest 风格的 URL. 
	 * 以 CRUD 为例: 
	 * 新增: /order POST 
	 * 修改: /order/1 PUT     update?id=1 
	 * 获取: /order/1 GET     get?id=1 
	 * 删除: /order/1 DELETE  delete?id=1
	 * 
	 * 如何发送 PUT 请求和 DELETE 请求呢 ? 
	 * 1. 须要配置 HiddenHttpMethodFilter 
	 * 2. 须要发送 POST 请求
	 * 3. 须要在发送 POST 请求时携带一个 name="_method" 的隐藏域, 值为 DELETE 或 PUT
	 * 
	 * 在 SpringMVC 的目标方法中如何获得 id 呢? 使用 @PathVariable 注解
	 * 
	 */
	@RequestMapping(value="/testREST/{id}" , method=RequestMethod.GET)
	public String testREST(@PathVariable("id") Integer id) {
		System.out.println("testREST GET : "+id);
		return SUCCESS;
	}
	
	@RequestMapping(value="/testREST" , method=RequestMethod.POST)
	public String testREST() {
		System.out.println("testREST POST");
		return SUCCESS;
	}
	
	@RequestMapping(value="/testREST/{id}" , method=RequestMethod.DELETE)
	public String testRESTdelete(@PathVariable("id") Integer id) {
		System.out.println("testREST DELETE："+id);
		return SUCCESS;
	}
	
	@RequestMapping(value="/testREST/{id}" , method=RequestMethod.PUT)
	public String testRESTput(@PathVariable("id") Integer id) {
		System.out.println("testREST PUT："+id);
		return SUCCESS;
	}
}