SpringMVC学习总结(二)@RequestMapping注解的功能、位置/@RequestMapping注解的属性/支持ant风格的路径/支持路径的占位符/@RequestMapping派生注解
一、@RequestMapping注解的功能
- 从注解名称上我们可以看到,@RequestMapping注解的作用就是将请求和处理请求的控制器方法关联起来,建立映射关系。
- SpringMVC 接收到指定的请求,就会来找到在映射关系中对应的控制器方法来处理这个请求。
二、@RequestMapping注解的位置
-
@RequestMapping注解
既可以标识在类上也可以标识在方法上
- @RequestMapping 标识一个类:设置映射请求的请求路径的初始信息
- @RequestMapping 标识一个方法:设置映射请求请求路径的具体信息
-
先访问初始信息 才能访问具体信息
案例:
首先,创建一个 web 模块并配置好web.xml和部署Tomcat
其次,在webapp/WEB-INF/templates/
下编写html文件:
- index.html:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org"><!--这个是thymeleaf命名空间-->
<head>
<meta charset="UTF-8">
<title>首页</title>
</head>
<body>
这是index.html<br>
<!--使用了thymeleaf的语法,它就会自动给我们在/target前面添加上下文路径-->
<a th:href="@{/test/testRequestMapping}">跳转到target.html</a>
</body>
</html>
- target.html:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
这是target.html
</body>
</html>
然后,编写请求控制器controller代码:
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class IndexController {
@RequestMapping("/")
public String testRequestMapping(){
return "index";
}
}
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping("/test")
public class MyController {
//此时请求映射所映射的请求的请求路径为:/test/testRequestMapping
@RequestMapping("/testRequestMapping")
public String testRequestMapping(){
return "target";
}
}
运行Tomcat:
假如有两个controller类,类上面都没有被@RequestMapping
注解,但它们都同时有一个@RequestMapping("/testRequestMapping")
注解的控制器方法,那么一运行就会报错。因为当浏览器访问到了localhost:8080/工程路径/testRequestMapping
的时候,向服务器发起请求,服务器不知道到底去找哪一个方法,因此我们就可以在两个controller类上面再加上不同value值的@RequestMapping
注解。
三、@RequestMapping注解的属性
(一)value属性
- @RequestMapping注解的value属性通过请求的请求地址匹配请求映射
- @RequestMapping注解的value属性是一个字符串类型的数组,表示该请求映射能够匹配多个请求地址所对应的请求
- @RequestMapping注解的其他属性可以不设置,但value属性必须设置
案例:
基于上例做了修改:
index.html:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org"><!--这个是thymeleaf命名空间-->
<head>
<meta charset="UTF-8">
<title>首页</title>
</head>
<body>
这是index.html<br>
<a th:href="@{/testRequestMapping}">跳转到target.html</a><br>
<a th:href="@{/testRM}">跳转到target.html</a>
</body>
</html>
controller:
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class MyController {
//value属性是一个数组,它表示该请求映射能匹配数组里任意一个地址
@RequestMapping(value = {"/testRequestMapping","/testRM"})
public String testRequestMapping(){
return "target";
}
}
1.SpringMVC支持ant风格的路径
?
:表示任意的单个字符(0个或多个都不行)*
:表示任意的0个或多个字符(单个也行)**
:表示任意的一层或多层目录(0层也行)
注意:在使用**
时,只能使用/**/xxx
的方式,而不能使用诸如/a**/xxx
或/**b/xxx
的方式
案例1:
index.html:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org"><!--这个是thymeleaf命名空间-->
<head>
<meta charset="UTF-8">
<title>首页</title>
</head>
<body>
这是index.html<br>
<a th:href="@{/a1a/testRM}">/a1a/testRM</a><br>
<a th:href="@{/aa/testRM}">/aa/testRM</a><br>
<a th:href="@{/a11a/testRM}">/a11a/testRM</a><br>
</body>
</html>
controller:
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class MyController {
@RequestMapping(value = "/a?a/testRM")
public String testRequestMapping(){
return "target";
}
}
点击第一个链接:
点击第二个链接:
点击第三个链接:
注:虽然说是任意的单个字符,但是?
和/
这种特殊的单个字符也是不行的:
案例2:
index.html:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org"><!--这个是thymeleaf命名空间-->
<head>
<meta charset="UTF-8">
<title>首页</title>
</head>
<body>
这是index.html<br>
<a th:href="@{/a1a/testRM}">/a1a/testRM</a><br>
<a th:href="@{/aa/testRM}">/aa/testRM</a><br>
<a th:href="@{/a11a/testRM}">/a11a/testRM</a><br>
</body>
</html>
controller:
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class MyController {
@RequestMapping(value = "/a*a/testRM")
public String testRequestMapping(){
return "target";
}
}
点击第一个链接:
点击第二个链接:
点击第三个链接:
案例3:
index.html:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org"><!--这个是thymeleaf命名空间-->
<head>
<meta charset="UTF-8">
<title>首页</title>
</head>
<body>
这是index.html<br>
<a th:href="@{/abc/testRM}">/abc/testRM</a><br>
<a th:href="@{/abc/abc/testRM}">/abc/abc/testRM</a><br>
<a th:href="@{/testRM}">/testRM</a><br>
</body>
</html>
controller:
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class MyController {
@RequestMapping(value = "/**/testRM")
public String testRequestMapping(){
return "target";
}
}
点击第一个链接:
点击第二个链接:
点击第三个链接:
2.SpringMVC支持路径中的占位符(重点)
- 原始方式传参:
/deleteUser?id=1
- RESTful方式传参:
/deleteUser/1
SpringMVC路径中的占位符常用于RESTful风格中,当请求路径中将某些数据通过路径的方式传输到服务器中,就可以在相应的@RequestMapping注解的value属性中通过占位符{xxx}
表示传输的数据,再通过 @PathVariable 注解修饰形参,将占位符所表示的数据自动赋值给控制器方法的形参。
案例:
index.html:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org"><!--这个是thymeleaf命名空间-->
<head>
<meta charset="UTF-8">
<title>首页</title>
</head>
<body>
这是index.html<br>
<a th:href="@{/testRM/1/mike}">跳转到target.html</a><br>
</body>
</html>
controller:
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class MyController {
@RequestMapping(value = "/testRM/{id}/{username}")
public String testRequestMapping(@PathVariable int id,@PathVariable String username){
System.out.println("id:"+id+",username:"+username);
return "target";
}
}
如果地址栏是localhost:8080/SpringMVC/testRM/
没有后面的参数,则会报错404。
(二)method属性
- @RequestMapping注解的method属性通过请求的请求方式(get或post)匹配请求映射
- @RequestMapping注解的method属性是一个RequestMethod类型的数组,表示该请求映射能够匹配多种请求方式的请求
- 若当前请求的请求地址满足请求映射的value属性,但是请求方式不满足method属性,则浏览器报错405。
案例:
index.html:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org"><!--这个是thymeleaf命名空间-->
<head>
<meta charset="UTF-8">
<title>首页</title>
</head>
<body>
这是index.html<br>
<!--get请求-->
<a th:href="@{/testRM}">跳转到target.html</a>
<!--post请求-->
<form th:action="@{/testRM}" method="post">
<input type="submit" value="跳转到target.html">
</form>
</body>
</html>
controller:
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
@Controller
public class MyController {
//method属性是一个数组,它表示请求映射能够匹配多种请求方式的请求
@RequestMapping(value = "/testRM",method = {RequestMethod.GET,RequestMethod.POST})
public String testRequestMapping(){
return "target";
}
}
两种方式都能成功跳转过来:
1.派生注解
- 常用的请求方式有get,post,put,delete,但是目前浏览器只支持get和post,若在form表单提交时,为method设置了其他请求方式的字符串(put或delete),则按照默认的请求方式get处理。若要发送put和delete请求,则需要通过spring提供的过滤器HiddenHttpMethodFilter,在后篇RESTful部分会讲到。
- 对于处理指定请求方式的控制器方法,SpringMVC中还提供了以下@RequestMapping的派生注解:
- 处理get请求的映射–>@GetMapping
- 处理post请求的映射–>@PostMapping
- 处理put请求的映射–>@PutMapping
- 处理delete请求的映射–>@DeleteMapping
案例:
index.html:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org"><!--这个是thymeleaf命名空间-->
<head>
<meta charset="UTF-8">
<title>首页</title>
</head>
<body>
这是index.html<br>
<!--get请求-->
<a th:href="@{/testRM}">跳转到target.html</a>
<!--post请求-->
<form th:action="@{/testRM}" method="post">
<input type="submit" value="跳转到target.html">
</form>
</body>
</html>
controller:
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
@Controller
public class MyController {
@GetMapping(value = "/testRM")
public String testRequestMapping(){
return "target";
}
}
此时,只有get请求能够成功访问:
而post请求不能访问:
(三)params属性(了解)
-
@RequestMapping注解的params属性通过请求的请求参数匹配请求映射
-
@RequestMapping注解的params属性是一个
字符串类型的数组
,可以通过以下四种表达式设置请求参数和请求映射的匹配关系:
"param"
:要求请求映射所匹配的请求必须携带param请求参数"!param"
:要求请求映射所匹配的请求必须不能携带param请求参数"param=value"
:要求请求映射所匹配的请求必须携带param请求参数且param=value"param!=value"
:要求请求映射所匹配的请求必须携带param请求参数但是param!=value
-
若当前请求满足@RequestMapping注解的value和method等属性,但是不满足params属性,此时页面回报错400。
案例:
index.html:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org"><!--这个是thymeleaf命名空间-->
<head>
<meta charset="UTF-8">
<title>首页</title>
</head>
<body>
这是index.html<br>
<!--thymeleaf语法,括号里面可以放参数列表,字符串用单引号引起来,会自动解析成?name=value-->
<a th:href="@{/testRM(username='admin',password=123)}">跳转到target.html</a>
</body>
</html>
controller:
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class MyController {
@RequestMapping(value = "/testRM",params = {"username","password!=123456"})
public String testRequestMapping(){
return "target";
}
}
将参数password改成别的就可以访问了:
(四)headers属性(了解)
-
@RequestMapping注解的headers属性通过请求的请求头信息匹配请求映射
-
@RequestMapping注解的headers属性是一个
字符串类型的数组
,可以通过以下四种表达式设置请求头信息和请求映射的匹配关系:
"header"
:要求请求映射所匹配的请求必须携带header请求头信息"!header"
:要求请求映射所匹配的请求必须不能携带header请求头信息"header=value"
:要求请求映射所匹配的请求必须携带header请求头信息且header=value"header!=value"
:要求请求映射所匹配的请求必须携带header请求头信息且header!=value
-
若当前请求满足@RequestMapping注解的value和method等属性,但是不满足headers属性,此时页面显示404错误,即资源未找到
案例:
index.html:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org"><!--这个是thymeleaf命名空间-->
<head>
<meta charset="UTF-8">
<title>首页</title>
</head>
<body>
这是index.html<br>
<a th:href="@{/testRM}">跳转到target.html</a>
</body>
</html>
controller:
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class MyController {
@RequestMapping(value = "/testRM",headers = "Connection=keep-alive")
public String testRequestMapping(){
return "target";
}
}