目录
4、基于 HiddentHttpMethodFilter 的示例
一、
RequestMapping 注解
1、使用说明
（1）源码：
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
public @interface RequestMapping {
}
（2）作用：
用于建立请求
URL
和处理请求方法之间的对应关系。
（3）出现位置：
-
类上：
请求
URL
的第一级访问目录。此处不写的话，就相当于应用的根目录。写的话需要以
/
开头。 它出现的目的是为了使我们的
URL
可以按照模块化管理
：
例如：
账户模块：
/account
/add
/account
/update
/account
/delete …
订单模块：
/order
/add
/order
/update
/order
/delete
红色的部分就是把
RequsetMapping
写在类上，使我们的 URL
更加精细。
-
方法上：
请求 URL 的第二级访问目录。
（4）属性：
value：
用于指定请求的 URL。它和 path 属性的作用是一样的。
method：
用于指定请求的方式。
params：
用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的 key 和 value 必须和配置的一模一样。 例如：params = {“moeny!=100”}，表示请求参数中 money 不能是 100。
headers：
用于指定限制请求消息头的条件。 注意： 以上四个属性只要出现 2 个或以上时，他们的关系是与的关系。
2、使用示例
（1）class 属性的示例
/**
* RequestMapping 注解出现的位置
* @Version 1.0
*/
@Controller("accountController")
@RequestMapping("/account")
public class AccountController {
@RequestMapping("/findAccount")
public String findAccount(){
System.out.println("查询了账户。。。。");
return "success";
}
}
jsp
中的代码：
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>requestmapping 的使用</title>
</head>
<body>
<!-- 第一种访问方式 -->
<a href="${pageContext.request.contextPath}/account/findAccount">查询 账户</a> <br/>
<!--第二种访问方式 -->
<a href="account/findAccount">查询账户</a>
</body>
</html>
注意：
当我们使用此种方式配置时，在
jsp
中第二种写法时，不要在访问
URL
前面加
/
，否则无法找到资源。
（2）method 属性的示例
控制器代码：
/**
* 保存账户
* @return
*/
@RequestMapping(value="/saveAccount",method=RequestMethod.POST)
public String saveAccount() {
System.out.println("保存了账户");
return "success";
}
jsp
代码：
<!-- 请求方式的示例 -->
<a href="account/saveAccount">保存账户，get 请求</a>
<br/>
<form action="account/saveAccount" method="post">
<input type="submit" value="保存账户，post 请求">
</form>
注意：
当使用
get
请求时，提示错误信息是
405
，信息是方法不支持
get
方式请求
（3）params 属性的示例：
控制器的代码：
/**
* 删除账户
* @return
*/
@RequestMapping(value="/removeAccount",params= {"accountName","money=100"})
public String removeAccount() {
System.out.println("删除了账户");
return "success";
}
jsp
中的代码：
<!-- 请求参数的示例 -->
<a href="account/removeAccount?accountName=aaa&money=100">删除账户， 金额 100</a>
<br/>
<a href="account/removeAccount?accountName=aaa&money=150">删除账户， 金额 150</a>
注意：
当我们点击第一个超链接时,可以访问成功。 当我们点击第二个超链接时，无法访问。因为 params= {“accountName”,”money=100″} ，限制了 money=100 的条件
二、RequestParam注解
1、使用说明
作用：
把请求中指定名称的参数给控制器中的形参赋值。
属性：
value
：请求参数中的名称。
required
：请求参数中是否必须提供此参数。
默认值：
true
。表示必须提供，如果不提供将报错。
2、使用示例
jsp
<!-- requestParams 注解的使用 -->
<a href="springmvc/useRequestParam?name=test">requestParam 注解</a>
控制器中的代码：
/**
* requestParams 注解的使用
*
* @param username
* @return
*/
@RequestMapping("/useRequestParam")
public String useRequestParam(@RequestParam("name") String username, @RequestParam(value = "age", required = false) Integer age) {
System.out.println(username + "," + age);
return "success";
}
运行结果：
三、RequestBody注解
1、使用说明
作用：
用于获取请求体内容。直接使用得到是
key=value&key=value…
结构的数据。
get 请求方式不适用
。
属性：
required
：是否必须有请求体。默认值是：t
rue
。
当取值为
true
时，
get
请求方式会报错。如果取值为 false
，
get
请求得到是
null
。
2、使用示例
post
请求
jsp
代码：
<!-- request body 注解 -->
<form action="springmvc/useRequestBody" method="post">
用户名称：<input type="text" name="username" ><br/>
用户密码：<input type="password" name="password" ><br/>
用户年龄：<input type="text" name="age" ><br/>
<input type="submit" value="保存">
</form>
get 请求
jsp 代码：
<a href="springmvc/useRequestBody?body=test">requestBody 注解 get 请求</a>
控制器代码：
/**
* RequestBody 注解
* @return
*/
@RequestMapping("/useRequestBody")
public String useRequestBody(@RequestBody(required=false) String body){
System.out.println(body);
return "success";
}
post
请求运行结果：
get
请求运行结果：
四、PathVaribale注解
1、使用说明
作用：
用于绑定
url
中的占位符。例如：请求
url
中
/delete/{id}
，这个
{id}
就是
url 占位符。 url
支持占位符是
spring3.0
之后加入的。是
springmvc
支持
rest
风格 URL 的一个重要标志。
属性：
value
：用于指定
url
中占位符名称。
required
：是否必须提供占位符。
2、使用示例
jsp
代码
:
<!-- PathVariable 注解 -->
<a href="springmvc/usePathVariable/100">pathVariable 注解</a>
控制器代码：
/**
* PathVariable 注解
*
* @return
*/
@RequestMapping("/usePathVariable/{id}")
public String usePathVariable(@PathVariable("id") Integer id) {
System.out.println(id);
return "success";
}
运行结果：
3、REST 风格 URL
（1）什么是 rest
REST
（英文：
Representational State Transfer
，简称
REST
）描述了一个架构样式的网络系统，比如 web
应用程序。它首次出现在
2000
年
Roy Fielding
的博士论文中，他是 HTTP
规范的主要编写者之一。在目前主流的三种
Web
服务交互方案中，
REST
相比于 SOAP
（
Simple Object Access protocol
，简单对象访问协议）以及
XML-RPC
更加简单明了，无论是对 URL
的处理还是对
Payload
的编码，
REST
都倾向于用更加简单轻量的方法设计和实现。值得注意的是
REST
并没有一个明确的标准，而更像是一种设计的风格
。它本身并没有什么实用性，其核心价值在于如何设计出符合 REST
风格的网络接口。
（2）restful 的优点
它结构清晰、符合标准、易于理解、扩展方便，所以正得到越来越多网站的采用。
（3）restful 的特性
资源（
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
用来删除资源
（4）
restful 的示例：
/account/1 HTTP GET
： 得到
id = 1
的
account
/account/1 HTTP DELETE
： 删除
id = 1
的
account
/account/1 HTTP PUT
： 更新
id = 1
的
account
/account HTTP POST
： 新增
account
4、基于 HiddentHttpMethodFilter 的示例
作用：
由于浏览器
form
表单只支持
GET
与
POST
请求，而
DELETE
、
PUT
等 method 并不支持，
Spring3.0
添加了一个过滤器
，可以将浏览器请求改为指定的请求方式，发送给我们的控制器方法，使得支持 GET
、
POST
、
PUT
与
DELETE
请求。
使用方法：
第一步：在
web.xml 中
配置该过滤器
。
HiddenHttpMethodFilter
第二步：请求方式
必须使用 post 请求
。
第三步：按照要求提供
_method
请求参数，该参数的取值就是我们需要的请求方式。
web.xml 中配置过滤器
<!--配置HiddenHttpMethodFilter-->
<!--
配置 org.springframework.web.filter.HiddenHttpMethodFilter: 可以把 POST 请求转为 DELETE 或 PUT 请求
-->
<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>
jsp
中示例代码
:
<!-- 保存 -->
<form action="account/testRestPOST" method="post">
用户名称：<input type="text" name="username"><br/>
<input type="hidden" name="_method" value="POST">
<input type="submit" value="保存">
</form>
<hr/>
<!-- 更新 -->
<form action="account/testRestPUT/1" method="post">
用户名称：<input type="text" name="username"><br/>
<input type="hidden" name="_method" value="PUT">
<input type="submit" value="更新"></form>
<hr/>
<!-- 删除 -->
<form action="account/testRestDELETE/1" method="post">
<input type="hidden" name="_method" value="DELETE">
<input type="submit" value="删除">
</form>
<hr/>
<!-- 查询一个 -->
<form action="account/testRestGET/1" method="post">
<input type="hidden" name="_method" value="GET">
<input type="submit" value="查询">
</form>
控制器中示例代码
/**
* post 请求：保存
*
* @return
*/
@RequestMapping(value = "/testRestPOST", method = RequestMethod.POST)
public String testRestfulURLPOST(String username) {
System.out.println("rest post , " + username);
return "success";
}
/**
* put 请求：更新
*
* @return
*/
@RequestMapping(value = "/testRestPUT/{id}", method = RequestMethod.PUT)
public String testRestfulURLPUT(@PathVariable("id") Integer id, String username) {
System.out.println("rest put , " + id + "," + username);
return "success";
}
/**
* post 请求：删除
*
* @return
*/
@RequestMapping(value = "/testRestDELETE/{id}", method = RequestMethod.DELETE)
public String testRestfulURLDELETE(@PathVariable("id") Integer id) {
System.out.println("rest delete , " + id);
return "success";
}
/**
* post 请求：查询
*
* @return
*/
@RequestMapping(value = "/testRestGET/{id}", method = RequestMethod.GET)
public String testRestfulURLGET(@PathVariable("id") Integer id) {
System.out.println("rest get , " + id);
return "success";
}
执行结果
五、RequestHeader注解
1、使用说明
作用：
用于获取请求消息头。
属性：
value：提供消息头名称 required：是否必须有此消息头
-
注：
在实际开发中一般不怎么用。
2、使用示例
jsp
中代码
<!-- RequestHeader 注解 -->
<a href="springmvc/useRequestHeader">获取请求消息头</a>
控制器中代码
:
/**
* RequestHeader 注解 * @param user * @return
*/
@RequestMapping("/useRequestHeader")
public String useRequestHeader(@RequestHeader(value = "Accept-Encoding", required = false) String requestHeader) {
System.out.println(requestHeader);
return "success";
}
执行结果：
六、CookieValue注解
1、使用说明
作用：
用于把指定
cookie
名称的值传入控制器方法参数。
属性：
value
：指定
cookie
的名称。
required
：是否必须有此
cookie
。
2、使用示例
jsp
中代码：
<!-- CookieValue 注解 -->
<a href="springmvc/useCookieValue">绑定 cookie 的值</a>
控制器中的代码：
/**
* Cookie 注解注解 * @param user * @return
*/
@RequestMapping("/useCookieValue")
public String useCookieValue(@CookieValue(value = "JSESSIONID", required = false) String cookieValue) {
System.out.println(cookieValue);
return "success";
}
执行结果：
七、SessionAttribute注解
1、使用说明
作用：
用于多次执行控制器方法间的参数共享。
属性：
value
：用于指定存入的属性名称
type
：用于指定存入的数据类型。
2、使用示例
jsp
中的代码
:
<!-- SessionAttribute 注解的使用 -->
<a href="account/testPut">存入 SessionAttribute</a>
<hr/>
<a href="account/testGet">取出 SessionAttribute</a>
<hr/>
<a href="account/testClean">清除 SessionAttribute</a>
控制器中的代码：
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.SessionAttributes;
import org.springframework.web.bind.support.SessionStatus;
@Controller
@RequestMapping("/account")
@SessionAttributes(value = {"username", "password"}, types = {Integer.class})
public class AccountController {
/**
* 把数据存入 SessionAttribute
*
* @param model
* @return Model 是 spring 提供的一个接口，该接口有一个实现类 ExtendedModelMap
* 该类继承了 ModelMap，而 ModelMap 就是 LinkedHashMap 子类
*/
@RequestMapping("/testPut")
public String testPut(Model model) {
model.addAttribute("username", "泰斯特");
model.addAttribute("password", "123456");
model.addAttribute("age", 31);
//跳转之前将数据保存到 username、password 和 age 中，因为注解 @SessionAttribute 中有这几个参数
System.out.println("testPut - 存入了数据");
return "success";
}
@RequestMapping("/testGet")
public String testGet(ModelMap model) {
System.out.println("testGet - 取数据 - " + model.get("username") + ";" + model.get("password") + ";" + model.get("age"));
return "success";
}
@RequestMapping("/testClean")
public String complete(SessionStatus sessionStatus) {
sessionStatus.setComplete();
System.out.println("testClean - 删除了数据");
return "success";
}
}
运行结果：
