• SpringMVC使用@RequestMapping注解为控制器指定可以处理哪些 URL 请求

  • 在控制器的类定义 及 方法定义 处都可标注 @RequestMapping

    • 标记在 类 上：提供初步的请求映射信息。相对于 WEB 应用的根目录
    • 标记在 方法 上：提供进一步的细分映射信息。相对于标记在类上的 URL。

  • 若类上未标注 @RequestMapping，则方法处标记的 URL 相对于 WEB 应用的根目录

作用：
DispatcherServlet 截获请求后，就通过控制器上 @RequestMapping 提供的映射信息确定请求所对应的处理方法

3.1 源码参考

  1. package org.springframework.web.bind.annotation;
  2. @Target({ElementType.METHOD, ElementType.TYPE})
  3. @Retention(RetentionPolicy.RUNTIME)
  4. @Documented
  5. @Mapping
  6. public @interface RequestMapping {
  7.     String[] value() default {};
  8.     RequestMethod[] method() default {};
  9.     String[] params() default {};
  10.     String[] headers() default {};
  11.     String[] consumes() default {};
  12.     String[] produces() default {};
  13. }

3.2 映射请求方式

  • 定义页面链接、控制器方法

html请求

  1. <a href="springmvc/helloworld">test @RequestMapping</a>
@Controller  //声明Bean对象，为一个控制器组件
@RequestMapping("/springmvc")
public class HelloWorldController {
/**
 * 映射请求的名称：用于客户端请求；类似Struts2中action映射配置的，action名称
 *1 使用@RequestMapping 注解来映射请求的 URL
 *2 返回值会通过视图解析器解析为实际的物理视图, 
对于 InternalResourceViewResolver 视图解析器, 
 * 会做如下的解析:
 *  通过 prefix + returnVal + 后缀 这样的方式得到实际的物理视图, 然会做转发操作.
 * /WEB-INF/views/success.jsp
 */
@RequestMapping(value="/helloworld")
    public String helloworld(){
    System.out.println("hello,world");
    return "success"; //结果如何跳转呢？需要配置映射解析器
    }        
}

3.3 映射请求参数&请求头

3.3.1 标准的 HTTP 请求报头

image.png

3.3.2 映射请求参数、请求方法或请求头

  • @RequestMapping 除了可以使用请求 URL 映射请求外，还可以使用请求方法、请求参数及请求头映射请求
  • @RequestMapping 的 value【重点】、method【重点】、params【了解】 及 heads【了解】
* RequestMapping的其他属性
*  method：限定请求方式
*      HTTP协议中的所有请求方式：
*      【GET】,【POST】,HEAD,PUT,PATCH,DELETE,OPTIONS,TRACE;
*      RequestMethod.GET：只接受GET类型的请求；默认是什么都接收
*      不是规定的方式就报错：4xx：都是客户端错误
*          405 - Request method 'GET' not supported
*  params：规定请求参数
*  headers：规定请求头
*  consumes：只接受内容类型是哪种请求，规定请求头中的Content-Type
*  produce：告诉浏览器返回的内容类型是什么，给响应头中加上Content-Type
  • 分别表示请求 URL、请求方法、请求参数及请求头的映射条件，他们之间是与的关系，联合使用多个条件可让请求映射更加精确化。

3.3.3 params 和 headers支持简单的表达式：

param1: 表示请求必须包含名为 param1 的请求参数
!param1: 表示请求不能包含名为 param1 的请求参数
param1 != value1: 表示请求包含名为 param1 的请求参数，但其值不能为 value1
{“param1=value1”, “param2”}: 请求必须包含名为 param1 和param2 的两个请求参数，且 param1 参数的值必须为 value1

image.png

//修改method属性，来指定改接收的请求类型
@RequestMapping(value = "/handle02",method = RequestMethod.GET)
public String handle02(){
    return "success";
}

//修改params属性，来指定改接收的请求是否含有或不含有什么参数
//params
@RequestMapping(value = "/handle03",params ={"!username"} )
public String handle03(){
    return "success";
}

//修改headers属性，来指定改接收的请求头是否含有什么参数，规定只接收来组火狐浏览器的请求
//headers
@RequestMapping(value = "/handle04",headers = {"User-Agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:90.0) Gecko/20100101 Firefox/90.0"})
public String handle04(){
    return "success";
}

3.4 Ant 路径风格

Ant 风格资源地址支持 3 种匹配符：【了解】
?：匹配文件名中的一个字符

*：匹配文件名中的任意字符

**：匹配多层路径

@RequestMapping 还支持 Ant 风格的 URL：
image.png
/user/*/createUser

匹配 /user/aaa/createUser、/user/bbb/createUser 等 URL

/user/**/createUser

匹配 /user/createUser、/user/aaa/bbb/createUser 等 URL

/user/createUser??

匹配 /user/createUseraa、/user/createUserbb 等 URL

3.5 占位符PathVariable

@PathVariable 映射 URL 绑定的占位符
带占位符的 URL 是 Spring3.0 新增的功能，该功能在 SpringMVC 向 REST 目标挺进发展过程中具有里程碑的意义

通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中：

URL 中的 {xxx} 占位符可以通过 @PathVariable(“xxx”) 绑定到操作方法的入参中。

①定义控制器方法

//@PathVariable 注解可以将请求URL路径中的请求参数，传递到处理请求方法的入参中
@RequestMapping(value="/testPathVariable/{id}")
                                //通过@PathVariable来获取@RequestMapping{}中的参数值
public String testPathVariable(@PathVariable("id") Integer id){
    System.out.println("testPathVariable...id="+id);
    return "success";
}

②请求链接

<!-- 测试 @PathVariable -->
<a href="springmvc/testPathVariable/1">testPathVariable</a>