Spring MVC 映射请求

内容概要

1.使用 @RequestMapping 映射请求
2.映射请求参数 & 请求头

使用 @RequestMapping 映射请求

Spring MVC 使用 @RequestMapping 注解为控制器指定可以处理哪些 URL 请求

在控制器的类定义及方法定义处都可标注@RequestMapping
– 类定义处：提供初步的请求映射信息。相对于 WEB 应用的根目录
– 方法处：提供进一步的细分的映射信息。相对于类定义处的 URL。

若类定义处未标注 @RequestMapping，则方法处标记的 URL 相对于
WEB 应用的根目录

DispatcherServlet 截获请求后，就通过控制器上 的@RequestMapping 提供的映射信息确定请求所对应的处理方法。

简述：请求方法、请求参数、请求头

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

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

params 和 headers支持简单的表达式：
– param1: 表示请求必须包含名为 param1 的请求参数
– !param1: 表示请求不能包含名为 param1 的请求参数
– param1 != value1: 表示请求包含名为 param1 的请求参数，但其值
不能为 value1
– {“param1=value1”, “param2”}:请求必须包含名为 param1 和param2的两个请求参数，且 param1 参数的值必须为 value1

示例：请求方法、请求参数、请求头

使用 @RequestMapping 映射请求： 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

示例：Ant风格资源地址

@PathVariable 映射 URL 绑定的占位符

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

通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中：
URL 中的 {xxx} 占位符可以通过@PathVariable(“xxx”) 绑定到操作方法的入参中。（注意：xxx表示占位符的名字，上述两个地方的名字必须相同）

REST简介

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

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

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

REST：关于状态转化

状态转化（State Transfer）：

每发出一个请求，就代表了客户端和服务器的一次交互过程。HTTP协议，是一个无状态协议，即所有的状态都保存在服务器端。

因此，如果客户端想要操作服务器，必须通过某种手段，让服务器端发生“状态转化”（State Transfer）。而这种转化是建立在表现层之上的，所以就是 “ 表现层状态转化”。

具体说，就是 HTTP 协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。它们分别对应四种基本操作：GET 用来获取资源，POST 用来新建资源，PUT 用来更新资源，DELETE用来删除资源。

REST：需要用到的过滤器

示例：

– /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 请求。

示例：REST风格URL

示例：REST风格URL对应的控制器方法

请求处理方法的签名

Spring MVC 通过分析处理方法的签名，将 HTTP 请求信息绑定到处理方法的相应入参中。

Spring MVC 对控制器处理方法签名的限制是很宽松的，几乎可以按喜欢的任何方式对方法进行签名。

必要时可以对方法及方法入参标注相应的注解（@PathVariable、@RequestParam、@RequestHeader 等）、Spring MVC 框架会将 HTTP 请求的信息绑定到相应的方法入参中，并根据方法的返回值类型做出相应的后续处理。

使用 @RequestParam 绑定请求参数值

在处理方法入参处使用 @RequestParam 可以把请求参数传递给请求方法
– value：参数名
– required：是否必须。默认为 true, 表示请求参数中必须包含对应的参数，若不存在，将抛出异常

使用 @RequestHeader 绑定请求报头的属性值

请求头包含了若干个属性，服务器可据此获知客户端的信息，

通过 @RequestHeader 即可将请求头中的属性值绑定到处理方法的入参中

    @RequestMapping("/test")
    public String test(@RequestHeader("Host") String host,//请求头中属性名称
                       @RequestHeader("Cookie") String cookie,//获取所有cookie｛
        System.out.println(host);
        System.out.println(cookie);
        return "test";
    }

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

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

会自动根据请求地址传递的参数名称自动封装到对象内对应的参数名称。

Spring MVC 会按请求参数名和 POJO 属性名进行自动匹配，自动为该对象填充属性值。支持级联属性。

如：dept.deptId、dept.address.tel 等

使用 Servlet API 作为入参

这些API已经自动装配过了，不用写入Spring容器中，能够自动注入。（相当于写入了Spring容器了一样）

MVC 的 Handler 方法可以接受哪些 ServletAPI 类型的参数

HttpServletRequest
 HttpServletResponse
 HttpSession

java.security.Principal
 Locale
 InputStream
 OutputStream
 Reader
 Writer