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

Posted 王祺灏

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了SpringMVC— “@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错误，即资源未找到

以上是关于SpringMVC— “@RequestMapping注解及其属性”的主要内容，如果未能解决你的问题，请参考以下文章

支付业务模块

第06课：服务网关

controller 允许跨域访问

RequestMapping 注解的解析匹配注册

从 Thymeleaf 下拉列表中获取选定的值

java.lang.IllegalStateException：不明确的映射。无法映射方法