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)

‌**:匹配任意多层路径(如 /user/**‌ 匹配 /user/123/profile)

‌注意事项‌

  • ‌默认支持所有 HTTP 方法‌:若未指定 method,则该方法响应所有请求方式(GET、POST、PUT 等)。
  • ‌避免映射冲突‌:同一路径+方法组合不能重复映射到多个方法,否则启动报错 Ambiguous mapping。
  • ‌类路径 + 方法路径 = 最终访问路径‌:如类上 /api,方法上 /user,则完整路径为 /api/user。
相关推荐
Highcharts.js3 小时前
Highcharts漏斗图表使用配置指南
java·开发语言·javascript·信息可视化·highcharts·漏斗图
武昌库里写JAVA8 小时前
SpringBoot+Vue 项目介绍
java·javascript·git·sql·ai
学长毕设9 小时前
基于SpringBoot的儿童慈善捐赠管理系统-附源码
java·spring boot·后端
慧一居士9 小时前
@RestControllerAdvice 的注解作用和使用
java
皮皮林55110 小时前
GitHub Copilot:你可以暂时不用,但别不知道它有多强
后端
学长毕设10 小时前
基于SpringBoot非遗文化展示与传播平台设计与实现-附源码
java·spring boot·后端
杨凯凡11 小时前
Spring Boot SSE 上线后不实时、频繁断线?Nginx 缓冲、心跳与连接回收实战
spring boot·后端·nginx
锋行天下11 小时前
langgraph 全栈项目(三)
前端·人工智能·后端
金銀銅鐵12 小时前
用 Swing 重做操作数栈演示
java·jvm·后端
琳少_12 小时前
java程序开发笔记
java·开发语言·数据库·笔记