Spring:@RequestMapping

@RequestMapping 是 Spring MVC 框架中最核心的注解之一，用于将 ‌HTTP 请求映射到控制器（Controller）中的处理方法‌，实现请求路由功能。
‌基本作用‌

建立 ‌URL 路径‌ 与 ‌控制器方法‌ 之间的映射关系。

可标注在 ‌类级别‌（定义公共路径前缀）或 ‌方法级别‌（定义具体请求路径）。

‌常用属性‌

属性类型说明

value / path String\[\] 指定请求路径，支持多个路径（如 "/user", "/api/user"）

method RequestMethod\[\] 指定支持的 HTTP 方法（如 GET, POST）

params String\[\] 限定请求必须包含特定参数（如 "username=admin"）

headers String\[\] 限定请求必须包含特定请求头（如 "Content-Type=application/json"）

consumes String\[\] 限定请求的内容类型（如 application/json）

produces String\[\] 限定响应的内容类型（如 application/xml）

示例：

@RequestMapping(value = "/user", method = RequestMethod.GET)

等价于 @GetMapping("/user")

‌派生注解（推荐使用）‌

为提升代码可读性，Spring 提供了针对常用 HTTP 方法的简化注解：

@GetMapping → @RequestMapping(method = GET)

@PostMapping → @RequestMapping(method = POST)

@PutMapping → @RequestMapping(method = PUT)

@DeleteMapping → @RequestMapping(method = DELETE)

@PatchMapping → @RequestMapping(method = PATCH)

推荐场景：当接口仅支持一种 HTTP 方法时，优先使用派生注解，语义更清晰、代码更简洁。

‌组合使用示例‌

@RestController

@RequestMapping("/api/users") // 类级别：公共前缀

public class UserController {

@GetMapping("/{id}") // 方法级别：/api/users/123

public User getUser(@PathVariable Long id) {

return userService.findById(id);

}

@PostMapping // /api/users

public User createUser(@RequestBody User user) {

return userService.save(user);

}

@RequestMapping(value = "/multi", method = {RequestMethod.GET, RequestMethod.POST})

public String multiMethod() {

return "支持 GET 和 POST";

}

‌路径变量与通配符‌

‌路径变量‌：使用 {} 定义变量，配合 @PathVariable 获取值

@GetMapping("/user/{id}")

public String getUser(@PathVariable("id") Long userId) { ... }

‌Ant 风格通配符‌：

*：匹配任意单个路径段（如 /user/* 匹配 /user/123）

&zwnj;**：匹配任意多层路径（如 /user/**&zwnj; 匹配 /user/123/profile）

‌注意事项‌