当前位置：首页 > ds >正文

Spring MVC 请求映射处理：@RequestMapping 与 @Pathvariable

ds 2025/5/6 4:55:17

文章目录

- - @RequestMapping 常用属性
  - @RequestMapping 使用案例
  - @RequestMapping 搭配 ANT 风格使用
  - @RequestMapping 衍生注解
  - @RequestMapping 搭配 @PathVariable 使用

@RequestMapping 注解是 Spring MVC 框架中一个用来映射请求到方法的注解，可用于类级别和方法级别。在类级别上， @RequestMapping 注解用于指定该控制器类处理的根路径或公共路径前缀。在方法级别上， @RequestMapping 注解用于指定具体的请求路径。可以将 @RequestMapping 注解与其他请求元数据一起使用，例如请求方法，请求类型、请求参数等，以更精确地映射请求。

@RequestMapping 常用属性

以下是 @RequestMapping 注解的常用属性：

属性	作用	说明
value	映射请求	当值有多个时，请求中匹配其一即可
method	指定请求方式	当值有多个时，请求中匹配其一即可
params	指定请求参数	当值有多个时，必须匹配所有值
headers	指定请求头	当值有多个时，必须匹配所有值

@RequestMapping 使用案例

以下是 @RequestMapping 注解的一些常见的使用案例：

案例	说明
`@RequestMapping(value={“/index1”,“/index2”})`	指定多个映射路径，映射路径包括 /index1 以及 /index2
`@RequestMapping(value=“/index”, method={RequestMethod.POST,RequestMethod.GET})`	指定单个映射路径为 /index 及请求方式支持 POST 与 GET
`@RequestMapping(value=“/”,params={“name”})`	请求参数中必须携带 name
`@RequestMapping(value=“/”,params={“!name”})`	请求参数中不能携带 name 参数
`@RequestMapping(value=“/”,params={“name=tom”})`	请求参数中必须携带 name 参数且 name 参数值只能为 tom
`@RequestMapping(value=“/”,params={“name!=tom”})`	请求参数中必须携带 name 参数且 name 参数值不能为 tom
`@RequestMapping(value=“/”,headers={“name”})`	请求头中必须携带 name
`@RequestMapping(value=“/”,headers={“!name”})`	请求头中不能携带 name
`@RequestMapping(value=“/”,headers={“name=tom”})`	请求头中必须携带 name 且 name 参数值为 tom
`@RequestMapping(value=“/”,headers={“name!=tom”})`	携带 name 参数，并且 name 参数值不为 tom

@RequestMapping 搭配 ANT 风格使用

@RequestMapping 注解可以使用 ANT 风格的路径模式进行匹配。ANT 风格的路径模式支持使用 ?、* 和 ** 进行通配符匹配：

符号	描述
`?`	匹配任意单个字符或不匹配任何字符
`*`	匹配任意多个字符（不包括路径分隔符 `/`）
`**`	匹配任意路径，可以跨多层目录

以下是常见的 ANT 风格路径案例：

注解	描述
`@RequestMapping(“/test”)`	匹配 /test
`@RequestMapping(“/te?t”)`	匹配 /tet、/test
`@RequestMapping(“/te*”)`	匹配 /te 以及以 /te 开头的任意路径
`@RequestMapping(“/te/**/t”)`	匹配 /te/t、/te/foo/t、/te/foo/bar/t 等

@RequestMapping 衍生注解

Spring MVC 中还有四个注解，可以称之为 @RequestMapping 注解的衍生注解：

注解	说明
`@GetMapping`	限制只能为 GET 请求
`@PostMapping`	限制只能为 POST 请求
`@PutMapping`	限制只能为 PUT 请求
`@DeleteMapping`	限制只能为 DELETE 请求

上述四个衍生注解的作用与 @RequestMapping 相同，只不过各个衍生注解对请求方式进行了限制。

@RequestMapping 搭配 @PathVariable 使用

其中，@PathVariable 注解用于从 URI 中提取数据作为方法参数。它允许在 URI 模板中定义的占位符（例如 {id}）与方法参数绑定，以便在处理请求时获取 URI 中的特定部分。

例如：

package test;import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/test")
public class TestController {@GetMapping("/{id}")public ResponseEntity<String> getUserById(@PathVariable Long id) {return ResponseEntity.ok().body("id的值为：" + id);}}