SpringMVC（3）— “@RequestMapping注解及其属性”

SpringMVC — "@RequestMapping注解"

一、@RequestMapping注解的功能

@RequestMapping注解的作用就是将浏览器的请求和相应的请求控制器方法关联起来，建立映射关系。SpringMVC 接收到指定的请求，就会来找到在映射关系中对应的控制器方法来处理这个请求。

二、@RequestMapping注解的位置

@RequestMapping标识一个类：设置映射请求的请求路径的初始信息
@RequestMapping标识一个方法：设置映射请求请求路径的具体信息

@Controller
@RequestMapping("/test")
public class RequestMappingController {
    
    
	/*
		此时请求映射所映射的请求的请求路径为：
		/test/testRequestMapping
	*/
    @RequestMapping("/testRequestMapping")
    public String testRequestMapping(){
    
    
        return "index";
    }

}

三、@RequestMapping注解的相关属性

双击@RequestMapping注解 —> Alt+7 查看结构

可以看到注解有如下几个属性，重点了解以下四个：
在这里插入图片描述

（1）value属性

@RequestMapping注解的value属性是一个字符串类型的数组（String[]），表示该请求映射能够匹配多个请求地址所对应的请求
@RequestMapping注解的value属性通过请求的请求地址匹配请求映射
@RequestMapping注解的value属性必须设置，至少通过请求地址匹配请求映射

@Controller
public class RequestMappingController {
    
    

	//设置多个请求地址映射同一个请求控制器
   @RequestMapping(value = {
    
    "/testtarget","/test1"})
    public String target(){
    
    
        return "target";
    }

}

index页面中设置超链接

<!DOCTYPE html>
<html lang="en"  xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>首页</title>
</head>
<body>
<h1>首页</h1>
<!--写一个超链接
th:href="@{/test1}"
使页面通过thymeleaf自动添加上下文路径
-->
<a th:href="@{/test1}">跳转到目标页-->/test1</a>
<a th:href="@{/testtarget}">跳转到目标页-->/testtarget</a>
</body>
</html>

运行结果：
两个超链接均可访问同一个页面（/target）

（2）method属性

method属性通过请求的请求方式（get或post）匹配请求映射
method属性是一个RequestMethod类型的数组，表示该请求映射能够匹配多种请求方式的请求(RequestMethod是一个枚举类，其中包含了各种请求方式)
若当前请求的请求地址满足请求映射的value属性，但是请求方式不满足method属性，则浏览器报错405：Request method 'POST' not supported

@Controller
public class RequestMappingController {
    
    

   @RequestMapping(
   		value = {
    
    "/testtarget","/test1"},
   		//设置该页面post和get提交方式均可访问
        method = {
    
    RequestMethod.POST,RequestMethod.GET}
    )
    public String target(){
    
    
        return "target";
    }

}

index页面：

<!DOCTYPE html>
<html lang="en"  xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>首页</title>
</head>
<body>
<h1>首页</h1>

<!--1.超链接（get提交方式）-->
<a th:href="@{/testtarget}">跳转到目标页-->/testtarget</a>

<!--2.表单（post提交方式）-->
<form th:action="@{/test1}" method="post">
    <input type="submit">
</form>

</body>
</html>

运行结果：
超链接和表单均可访问 target页面

注：
1、对于处理指定请求方式的控制器方法，SpringMVC中提供了@RequestMapping的派生注解
处理get请求的映射–> @GetMapping
处理post请求的映射–> @PostMapping
处理put请求的映射–> @PutMapping
处理delete请求的映射–> @DeleteMapping
使用派生注解就不用使用@RequestMapping注解了，value属性可在派生注解中直接设置
如：@GetMapping（value="/target"）

2、常用的请求方式有get，post，put，delete
但是目前浏览器只支持get和post，若在form表单提交时，为method设置了其他的请求方式（put或delete），则按照默认的请求方式 get 处理
若要发送put和delete请求，则需要通过spring提供的过滤器HiddenHttpMethodFilter，在RESTful部分会讲到

（3）params属性（了解）

params属性通过请求的请求参数匹配请求映射
params属性是一个字符串类型的数组，可以通过四种表达式设置请求参数和请求映射的匹配关系：

（1）"param"：要求请求映射所匹配的请求必须携带param请求参数
（2）"!param"：要求请求映射所匹配的请求必须不能携带param请求参数
（3）"param=value"：要求请求映射所匹配的请求必须携带param请求参数且param=value
（4）"param!=value"：要求请求映射所匹配的请求必须携带param请求参数但是param!=value

@Controller
public class RequestMappingController {
    
    

 @RequestMapping(
            value = {
    
    "/testtarget","/test1"},
            method = {
    
    RequestMethod.POST},
            //要求password参数的值不等于123
            params = {
    
    "username='admin',password!=123"}
    )
    public String test1(){
    
    
        return "target";
    }
}

<!--在index页面中设置超链接-->
<a th:href="@{/test(username='admin',password=123456)">
测试@RequestMapping的params属性
</a><br>

运行结果：
因为password的值为123456不等于123，所以访问页面成功

注：
若当前请求满足@RequestMapping注解的value和method属性，但是不满足params属性，此时页面报错400：Parameter conditions "username, password!=123456" not met for actual request parameters: username={admin}, password={123456}

（3）headers属性（了解）

@RequestMapping注解的headers属性通过请求的“请求头信息”匹配请求映射
@RequestMapping注解的headers属性是一个字符串类型的数组，可以通过四种表达式设置请求头信息和请求映射的匹配关系

（1）"header"：要求请求映射所匹配的请求必须携带header请求头信息
（2）"!header"：要求请求映射所匹配的请求必须不能携带header请求头信息
（3）"header=value"：要求请求映射所匹配的请求必须携带header请求头信息且header=value
（4）"header!=value"：要求请求映射所匹配的请求必须携带header请求头信息且header!=value

若当前请求满足@RequestMapping注解的value和method属性，但是不满足headers属性，此时页面显示404错误，即资源未找到

四、SpringMVC支持路径中的占位符（重点）

原始方式：/deleteUser?id=1

rest方式：/deleteUser/1

SpringMVC路径中的占位符常用于RESTful风格中，当请求路径中将某些数据通过路径的方式传输到服务器中，就可以在相应的@RequestMapping注解的value属性中通过占位符{xxx}表示传输的数据，在通过 @PathVariable注解，将占位符所表示的数据赋值给控制器方法的形参

<!--在index页面中编写超链接，点击链接后跳转至target页面-->
<a th:href="@{/testRest/1/admin}">测试路径中的占位符-->/testRest</a><br>

@RequestMapping(value = "/test2/{id}/{username}")
    public String test2(@PathVariable("id") String id,@PathVariable("username") String username){
    
    
        System.out.println("id="+id+",username="+username);
        return "target";
    }

执行结果：
控制台打印
在这里插入图片描述

五、总结

不满足method属性，则浏览器405错误
不满足params属性，此时浏览器400错误
不满足headers属性，此时浏览器显示404错误，即资源未找到