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

Posted 一切因为是码农

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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:不明确的映射。无法映射方法