经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置：技术经验 » Java相关 » Spring » 查看文章
SpringMVC?@RequestMapping注解详解
来源：jb51　　时间：2021/12/31 10:41:01　　对本文有异议

一、@RequestMapping

@RequestMapping注解的源码：

  1. @Target({ElementType.TYPE, ElementType.METHOD})
  2. @Retention(RetentionPolicy.RUNTIME)
  3. @Documented
  4. @Mapping
  5. public @interface RequestMapping {
  6.     String name() default "";
  7.     @AliasFor("path")
  8.     String[] value() default {};
  9.     @AliasFor("value")
  10.     String[] path() default {};
  11.     RequestMethod[] method() default {};
  12.     String[] params() default {};
  13.     String[] headers() default {};
  14.     String[] consumes() default {};
  15.     String[] produces() default {};
  16. }

1.@RequestMapping注解的功能

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

2.@RequestMapping注解的位置

@RequestMapping标注在类：设置映射请求请求路径的初始信息（通常用于表示某个模块的信息）
@RequestMapping标注在方法：设置映射请求请求路径的具体信息
@RequestMapping相同的请求地址一定只有一个RequestMapping映射，否则会报错。
浏览器先匹配类上标注的@Requestmapping，再匹配方法上的@Requestmapping，即请求地址url = 类请求路径 + 方法请求路径

  1. @Controller
  2. @RequestMapping("/hello")
  3. public class DisplayController {
  4.     @RequestMapping("/displayTest")
  5.     //此时的请求实际就是/hello/displayTest
  6.     public String displayTest(){
  7.         return "display";
  8.     }
  9. }

此时需要映射的请求地址实际就是http://localhost:8080/hello/display

  1. <!--浏览器解析的是绝对路径，会将"/"解析为"localhost:8080/"-->
  2. <a th:href="@{/hello/displayTest}" rel="external nofollow" >访问display页面...</a>

二、@RequestMapping注解的属性

1.value属性（掌握）

value属性是通过请求地址来匹配请求映射（默认是value），value属性是一个String类型的数组，表示该请求能够匹配多个请求地址所对应的请求，value属性必须设设置，至少通过请求地址映射来匹配请求映射。

  1. //表示可以通过地址testWorld或者hello/testWorld都可以访问world.html
  2. //@RequestMapping请求地址与方法名没有关系，但是为了方便习惯上使用方法名
  3. @RequestMapping(value = {"testWorld","hello/testWorld"})
  4. public String testWorld(){
  5.     return "world";
  6. }

此时需要映射的请求地址实际就是http://localhost:8080/testWorld或者http://localhost:8080/hello/testWorld

  1. <!--浏览器解析的是绝对路径，会将"/"解析为"localhost:8080/"-->
  2. <a th:href="@{/hello/testWorld}" rel="external nofollow" >@{/hello/testWorld}访问helloworld页面...</a><br>
  3. <a th:href="@{/testWorld}" rel="external nofollow"  rel="external nofollow" >@{/testWorld}访问helloworld页面...</a><br>

2.method属性（掌握）

method是通过请求方式（get/post）匹配请求映射，method属性是一个RequestMethod[]类型的数组，表示该种请求可以匹配多种请求方式对应的请求。如果当前请求的请求映射满足value属性，但是不满足method属性，就会报错405，报错：Request method 'POST' not supported

get和post两种常见的请求方式有何区别？
get：使用?将请求参数与请求地址拼接起来，格式:?请求参数名=请求参数值&请求参数名=请求参数值，不安全，传输速度快（请求地址也会传输），传输数据量有限，不能用于上传文件
post：请求参数放在请求体中（格式：请求参数名=请求参数值&请求参数名=请求参数值），安全，传输速度慢，传输数据量大

  1. //表示可以通过地址testWorld或者hello/testWorld都可以访问world.html
  2. @RequestMapping(value = {"testWorld","hello/testWorld"},method = {RequestMethod.GET,RequestMethod.POST})
  3. public String testWorld(){
  4.     return "world";
  5. }
  1. <!--浏览器解析的是绝对路径，会将"/"解析为"localhost:8080/"-->
  2. <a th:href="@{/testWorld}" rel="external nofollow"  rel="external nofollow" >@{/testWorld}访问helloworld页面（GET请求（默认））</a><br>
  3. <form th:action="@{/testWorld}" method="post">
  4.     <input type="submit" value="@{/testWorld}访问helloworld页面（POST请求）">
  5. </form>

此时访问get请求正常，访问post请求，请求方式不匹配（请求不支持），报错误405

在这里插入图片描述

将WorldController的@RequestMapping改为@RequestMapping(value = {"testWorld","hello/testWorld"},method = {RequestMethod.GET,RequestMethod.POST})，再次访问post和get请求，请求成功。

在这里插入图片描述

3.params属性（了解）

params属性是指通过请求的参数匹配处理请求的映射，params属性是一个String类型的数组，表示通过四种表达式设置请求参数和请求映射匹配关系。
“param”：要求请求映射所匹配的请求必须携带param请求参数
“!param”：要求请求映射所匹配的请求必须不能携带param请求参数
“param=value”：要求请求映射所匹配的请求必须携带param请求参数且param=value
“param!=value”：要求请求映射所匹配的请求必须携带param请求参数但是param!=value

  1. //处理请求的参数只能是username和password，且username=admin、password=12345678
  2. @RequestMapping(value = "/testParams",params = {"username=admin","password=12345678"})
  3. public String testParams(){
  4.     return "world";
  5. }
  1. <!--浏览器解析的是绝对路径，会将"/"解析为"localhost:8080/"-->
  2. <!--此处使用单引号，双引号会报错-->
  3. <!--会自动转化为?传参-->
  4. <a th:href="@{/testParams(username='admin',password=12345678)}" rel="external nofollow"  rel="external nofollow" >测试params参数</a><br>

可以看到请求参数已经使用?进行了拼接，请求访问成功，

在这里插入图片描述

将请求改为如下，再次访问，@RequestMapping请求参数不匹配，报400

  1. <a th:href="@{/testParams(username='root',password=12345678)}" rel="external nofollow" >测试params参数root</a><br>

在这里插入图片描述

4.headers属性（了解）

headers属性通过请求的请求头信息匹配请求映射，headers属性是一个String类型的数组，表示可以通过四种表达式设置请求头信息和请求映射的匹配信息。
“header”：要求请求映射所匹配的请求必须携带header请求头信息
“!header”：要求请求映射所匹配的请求必须不能携带header请求头信息
“header=value”：要求请求映射所匹配的请求必须携带header请求头信息且header=value
“header!=value”：要求请求映射所匹配的请求必须携带header请求头信息且header!=value
若当前请求满足@RequestMapping注解的value和method属性，但是不满足headers属性，此时页面显示404错误，即资源未找到

  1. //此时的请求的params中username=admin，password=1234545678,并且端口号是8081才可以成功，否则报错
  2. @RequestMapping(value = "/testParams",
  3.         params = {"username=admin","password=12345678"},
  4.         headers = {"host=localhost:8081"})
  5. public String testParams(){
  6.     return "world";
  7. }
  1. <a th:href="@{/testParams(username='admin',password=12345678)}" rel="external nofollow"  rel="external nofollow" >测试params参数</a><br>

可以看到未找到，@RequestMapping的请求头参数不匹配，报错误404

在这里插入图片描述

将端口号改为8080，再次测试。

  1. //此时的请求的params中username=admin，password=1234545678,并且端口号是8080才可以成功，否则报错
  2. @RequestMapping(value = "/testParams",
  3.         params = {"username=admin","password=12345678"},
  4.         headers = {"host=localhost:8080"})
  5. public String testParams(){
  6.     return "world";
  7. }

可以看到访问成功

在这里插入图片描述

总结：
@RequestMapping没有和任意参数匹配，报错误404
@RequestMapping的请求头参数不匹配，报错误404
@RequestMapping请求参数（params）不匹配，报错误400
@RequestMapping请求方式不匹配（请求不支持），报错误405

5.SpringMVC支持ant风格的路径

?：表示任意的单个字符
*：表示任意的0个或多个字符
**：表示任意的一层或多层目录
注意：在使用**时，只能使用/**/xxx的方式

  1. //@RequestMapping(value = "/a?a/testAnt")
  2. //@RequestMapping(value = "/a*a/testAnt")
  3. @RequestMapping(value = "/**/testAnt")
  4. public String testAnt(){
  5.     return "world";
  6. }
  1. <a th:href="@{/a1a/testAnt}" rel="external nofollow"  rel="external nofollow"  rel="external nofollow" >测试ant风格--->?</a><br>
  2. <a th:href="@{/a1a/testAnt}" rel="external nofollow"  rel="external nofollow"  rel="external nofollow" >测试ant风格--->*</a><br>
  3. <a th:href="@{/a1a/testAnt}" rel="external nofollow"  rel="external nofollow"  rel="external nofollow" >测试ant风格--->**</a><br>

6.SpringMVC支持路径中的占位符（重点）

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

  1. @RequestMapping("/testRest/{username}/{password}")
  2. public String testRest(@PathVariable("username") String username,@PathVariable("password") String password){
  3.     System.out.println("username="+username);
  4.     System.out.println("password="+password);
  5.     return "world";
  6. }
  1. <!--浏览器解析的是绝对路径，会将"/"解析为"localhost:8080/"-->
  2. <a th:href="@{/testRest/小王/123456}" rel="external nofollow" >测试rest占位符</a><br>

可以看到没有使用?连接，使用了rest方式实现了访问。

在这里插入图片描述

查看idea的控制台，数据通过路径的方式传输到服务器中。

在这里插入图片描述

三、@RequestMapping的派生类注解

对于处理指定请求方式的控制器方式，SpringMVC提供了@RequestMapping的派生类注解：
处理post请求的映射—>@PostMapping
处理get请求的映射—>@GetMapping
处理put请求的映射—>@PutMapping
处理delete请求的映射—>@DeleteMapping
但是目前浏览器只支持get和post，若在form表单提交时，为method设置了其他请求方式的字符串(put或delete)，则按照默认的请求方式（get）处理。

  1. @GetMapping("testGetMapping")
  2. public String testGetMapping(){
  3.     return "world";
  4. }
  1. <!--浏览器解析的是绝对路径，会将"/"解析为"localhost:8080/"-->
  2. <a th:href="@{/testGetMapping}" rel="external nofollow" >@{/testGetMapping}访问helloworld页面...</a><br>

在这里插入图片描述

测试form表单是否支持put或delete方式的请求

当请求和请求映射的方式不匹配时就会报错405.

  1. //当前请求映射的请求地址是testPut，请求方式是put方式
  2. @RequestMapping(value = "/testPut",method = RequestMethod.PUT)
  3. public String testPut(){
  4.     return "world";
  5. }
  1. <!--测试form表单是否支持put或delete方式的请求-->
  2. <form th:action="@{/testPut}" method="put">
  3.     <input type="submit" value="测试form表单是否支持put或delete方式的请求">
  4. </form>

结果如下：
若在form表单提交时，为method设置了其他请求方式的字符串(put或delete)，则按照默认的请求方式（get）处理。若要发送put和delete请求，则需要通过spring提供的过滤器HiddenHttpMethodFilter，在restful部分会讲到。

在这里插入图片描述

到此这篇关于SpringMVC @RequestMapping注解详解的文章就介绍到这了,更多相关SpringMVC @RequestMapping内容请搜索w3xue以前的文章或继续浏览下面的相关文章希望大家以后多多支持w3xue！

 友情链接：直通硅谷 　点职佳 　北美留学生论坛

Spring热门文章

  • 解决springboot+activemq启动报注解错误的问题
  • Springboot整合Rabbitmq之Confirm和Return机制
  • SpringBoot SpringEL表达式的使用
  • SpringBoot自动配置原理,你真的懂吗?(简单易懂)
  • Spring源码：Bean生命周期（终章）
  • Springboot-Management的项目实践
  • 解决springboot 启动找不到主类的问题
  • Spring5路径匹配器PathPattern解析
  • SpringAOP如何获取方法参数上的注解
  • java与es8实战之五：SpringBoot应用中操作es8(带安全检查：https、账号密码、API Key)

    • Spring推荐文章

  • SpringBoot Session共享，配置不生效问题排查 → 你竟然在代码里下毒！
  • 【Spring源码分析】Spring Scope功能中的动态代理 - Scoped Proxy
  • Spring AOP概念及原理
  • SpringBoot2.7还是任性的，就是不支持Logback1.3，你能奈他何
  • SpringBoot+ Sharding Sphere 轻松实现数据库字段加解密
  • Spring MVC 中视图的实现原理，在Spring MVC 中实现重定向和转发，以及访问静态资源 - Rainbow-Sea
  • Spring MVC 中 HttpMessageConverter 转换器 - Rainbow-Sea
  • SpringBoot+mail 轻松实现各类邮件自动推送
  • Spring MVC 获取三个域(request请求域，session 会话域，application 应用域)对象的方式 - Rainbow-Sea
  • SpringBoot3整合SpringDoc实现在线接口文档

    • 本站QQ群：前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

    W3xue 的所有内容仅供测试，对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
    关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接（目前9元/月）请联系QQ：27243702 沸活量
    皖ICP备17017327号-2　皖公网安备34020702000426号