（一）Springmvc学习笔记——关于使用 @RequestMapping 映射请求

Spring MVC 使用@RequestMapping 注解为控制器指定可以处理哪些 URL 请求 ，在控制器的类定义及方法定义处都可标注。DispatcherServlet 截获请求后，通过控制器上@RequestMapping 提供的映射信息确定请求所对应的处理方法。

1.RequestMapping注解的两种使用方式

    – 类定义处：提供初步的请求映射信息。相对于 WEB 应用的根目录

@RequestMapping("/springmvc")
@Controller
public class SpringMVCTest {
	@RequestMapping("/testRequestMapping")
	public String testRequestMapping() {
		System.out.println("testRequestMapping");
		return "success";
	}

}

Test RequestMapping

    – 方法处：提供进一步的细分映射信息。相对于类定义处的 URL。若类定义处未标注 @RequestMapping，则方法处标记的 URL 相对于 WEB 应用的根目录

/**
* 1. @RequestMapping 除了修饰方法, 还可来修饰类 
* 2.1)类定义处: 提供初步的请求映射信息。相对于 WEB 应用的根目录
* 2.2)方法处: 提供进一步的细分映射信息。相对于类定义处的 URL。若类定义处未标注     
* @RequestMapping，则方法处标记的URL相对于 WEB 应用的根目录
*/
@RequestMapping("/testRequestMapping")
public String testRequestMapping() {
	System.out.println("testRequestMapping");
	return "success";
}

Test RequestMapping

2.映射请求参数、请求方法或请求头

@RequestMapping 除了可以使用请求 URL 映射请求外，还可以使用请求方法、请求参数及请求头映射请求。

2.1）@RequestMapping 的 value、method、params 及 heads 分别表示请求 URL、请求方法、请求参数及请求头的映射条件，他们之间是与的关系，联合使用多个条件可让请求映射更加精确化。params 和 headers支持简单的表达式：

     – param1: 表示请求必须包含名为 param1 的请求参数

     – !param1: 表示请求不能包含名为 param1 的请求参数

     – param1 != value1: 表示请求包含名为 param1 的请求参数，但其值不能为 value1

     – {“param1=value1”, “param2”}: 请求必须包含名为 param1 和param2 的两个请求参数，且 param1 参数的值必须为 value1

• @RequestMapping 的method请求方式demo

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

•  @RequestMapping 的params请求参数及headers请求头demo

//了解: 可以使用params和headers 来更加精确的映射请求. params和headers支持简单的表达式
@RequestMapping(value = "testParamsAndHeaders", params = { "username",
			"age!=10" }, headers = { "Accept-Language=en-US,zh;q=0.8" })
public String testParamsAndHeaders() {
	System.out.println("testParamsAndHeaders");
	return "success";
}

Test ParamsAndHeaders

 2.2）使用 @RequestMapping 映射请求Ant风格的URL

    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

 2.3）@PathVariable 映射 URL 绑定的占位符

    带占位符的 URL 是 Spring3.0 新增的功能，该功能在 SpringMVC 向 REST 目标挺进发展过程中具有里程碑的意义，通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的参数中：URL 中的 {xxx} 占位符可以通过 @PathVariable("xxx") 绑定到操作方法的参数中。

Test PathVariable

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

2.4）使用REST风格的URL请求

    REST：即 Representational State Transfer。（资源）表现层状态转化。是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便， 所以正得到越来越多网站的采用。每发出一个请求，就代表了客户端和服务器的一 次交互过程。HTTP协议是一个无状态协议，即所有的状态都保存在服务器端。因此，如果客户端想要操作服务器，必须通过某种手段，让服务器端发生“ 状态转化”（State Transfer）。而这种转化是建立在表现层之上的，所以就是 “ 表现层状态转化” 。具体说，就是 HTTP 协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。它们分别对应四种基本操作：GET 用来获取资源，POST 用来新建资源，PUT 用来更新资源，DELETE 用来删除资源。

   REST风格的URL请求示例：

• /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

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

要实现REST风格的URL请求，首先需要在项目中的web.xml文件中添加HiddenHttpMethodFilter过滤器，如下所示：

  
	
		HiddenHttpMethodFilter
		org.springframework.web.filter.HiddenHttpMethodFilter
	
	
		HiddenHttpMethodFilter
		/*
	

    /**
     * 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.PUT)
	public String testRestPut(@PathVariable Integer id) {
		System.out.println("testRest Put: " + id);
		return "success";
	}

	@RequestMapping(value = "/testRest/{id}", method = RequestMethod.DELETE)
	public String testRestDelete(@PathVariable Integer id) {
		System.out.println("testRest Delete: " + 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.GET)
	public String testRest(@PathVariable Integer id) {
		System.out.println("testRest GET: " + id);
		return "success";
	}

    

		
		
	
	


	
	

		
		
	
	


	
	

		
	
	


	
	Test Rest Get

 2.5）使用 @RequestParam 绑定请求参数值

    在处理方法入参处使用 @RequestParam 可以把请求参数传递给请求方法

       value：参数名

       required：是否必须。默认为 true, 表示请求参数中必须包含对应 的参数，若不存在，将抛出异常

    /**
     * @RequestParam 来映射请求参数.
     * value 值即请求参数的参数名
     * required 该参数是否必须. 默认为 true
     * defaultValue 请求参数的默认值
     */
	@RequestMapping(value = "/testRequestParam")
      //这里的age如果设置为int类型，则必须设置默认值，否则其底层会自动转换类型时报错，
      //也可以直接设置为Integer类型，不需要设置默认值，不传值则为null
	public String testRequestParam(
			@RequestParam(value = "username") String un,
			@RequestParam(value = "age", required = false, defaultValue = "0") int age) {
		System.out.println("testRequestParam, username: " + un + ", age: "
				+ age);
		return "success";
	}

Test RequestParam

2.6）使用 @RequestHeader 绑定请求报头的属性值（用法同 2.5 RequestParam）

2.7）使用 @CookieValue 绑定请求中的 Cookie 值

    //@CookieValue: 映射一个 Cookie 值. 属性同 @RequestParam（了解）
	@RequestMapping("/testCookieValue")
	public String testCookieValue(@CookieValue("JSESSIONID") String sessionId) {
		System.out.println("testCookieValue: sessionId: " + sessionId);
		return "success";
	}

Test CookieValue

2.8）使用 POJO 对象绑定请求参数值

    Spring MVC 会按请求参数名和 POJO 属性名进行自动匹配，自动为该对象填充属性值。支持级联属性，如：dept.deptId、dept.address.tel 等

    
    

		username: 
		

		password: 
		

		email: 
		

		age: 
		

		city: 
		

		province: 
		

		
	

public class User {
    private Integer id;
    private String username;
    private String password;
    private String email;
    private int age;
    //级联属性对象
    private Address address;
    //实现所有属性的setter和getter方法...
}
public class Address {
    private String province;
    private String city;
    //实现所有属性的setter和getter方法...
}
    //springmvc的controller层的请求处理方法
    @RequestMapping("/testPojo")
    public String testPojo(User user) {
        System.out.println("testPojo: " + user);
        return "success";
    }

2.9）springMVC的 Handler 方法中使用ServletAPI 类型的参数

	/**
	 * 可以使用 Serlvet 原生的 API 作为目标方法的参数 具体支持以下类型
	 * HttpServletRequest 
	 * HttpServletResponse 
	 * HttpSession
	 * java.security.Principal 
	 * Locale  
	 * InputStream 
	 * OutputStream 
	 * Reader 
	 * Writer
	 * @throws IOException 
	 */
	@RequestMapping("/testServletAPI")
	public void testServletAPI(HttpServletRequest request,
			HttpServletResponse response, Writer out) throws IOException {
		System.out.println("testServletAPI, " + request + ", " + response);
		out.write("hello springmvc");
		//return SUCCESS;
	}