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

Spring MVC 如何映射 HTTP 请求到 Controller 方法？

news 来源：原创 2025/4/30 5:38:36

我们来详细分析一下如何在 Spring MVC 中将 HTTP 请求映射到 Controller 的处理方法（Handler Methods）上，以及 @RequestMapping 注解的使用方法。

请求映射的核心：@RequestMapping 注解

@RequestMapping 是 Spring MVC 中最核心、最通用的映射注解。它可以用于类级别（Class-level）和方法级别（Method-level）。

  1. 类级别映射 (Class-level Mapping):

    • 当 @RequestMapping 应用在类上时，它定义了Controller 处理所有请求的基类URL 路径。
    • 这样可以避免在每个方法上添加重复相同的路径前缀。

  2. 方法级别映射 (Method-level Mapping):

    • 当 @RequestMapping 应用在方法上时，它指定了该方法具体处理哪个（或哪些）URL 路径的请求。
    • 这个路径是相对于类级别路径的（如果存在的话）。

@RequestMapping 的主要属性：

  • value 或 path:

    • 指定映射的 URL 路径。可以是一个字符串数组，表示映射多个路径到同一个方法。
    • 支持 Ant 风格的路径模式（如 *, **, ?）和 URI 模板变量（路径变量，如 {userId}）。
    • value 和 path 是同义词，可以互换使用。

  • method:

    • 指定该方法处理的 HTTP 请求方法（GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, TRACE）。
    • 可以是一个 RequestMethod 枚举值的数组，表示处理多种 HTTP 方法。
    • 如果不指定，默认会匹配 所有 HTTP 方法。

  • params:

    • 根据请求参数（Query Parameters 或 Form Data）进行映射。只有当请求中包含（或不包含，或具有特定值）指定的参数时，才会匹配成功。
    • 表达式语法：
      • "myParam": 参数 myParam 必须存在。
      • "!myParam": 参数 myParam 必须不存在。
      • "myParam=myValue": 参数 myParam 必须存在且值为 myValue。
      • "myParam!=myValue": 参数 myParam 必须存在且值不为 myValue。
      • 可以组合多个条件，如 {"myParam=val", "otherParam"}（AND 关系）。

  • headers:

    • 根据请求头（Request Headers）进行映射。只有当请求包含（或不包含，或具有特定值）指定的头信息时，才会匹配成功。
    • 语法与 params 类似，如 "Accept=application/json", "!User-Agent", "X-Custom-Header=value"。

  • consumes:

    • 指定该方法能够处理的请求的 Content-Type（即客户端发送的数据类型）。只有当请求的 Content-Type Header 与指定的值匹配时，才会映射成功。
    • 例如：consumes = "application/json" 或 consumes = MediaType.APPLICATION_JSON_VALUE。可以指定多个，如 {"application/json", "application/xml"}。

  • produces:

    • 指定该方法能够生成的响应的 Content-Type（即服务器返回的数据类型）。Spring 会根据请求的 Accept Header 和此属性进行内容协商（Content Negotiation），选择最合适的 HttpMessageConverter 来序列化返回值。
    • 例如：produces = "application/json" 或 produces = MediaType.APPLICATION_JSON_VALUE。可以指定多个。

示例：使用 @RequestMapping

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;
import org.springframework.http.MediaType;@Controller
@RequestMapping("/users") // 类级别映射，所有方法都在 /users 路径下
public class UserController {// 映射 GET /users/{id}@RequestMapping(value = "/{id}", method = RequestMethod.GET, produces = MediaType.APPLICATION_JSON_VALUE)@ResponseBody // 如果用 @Controller 需要加这个来返回数据public User getUser(@PathVariable Long id) {// ... 获取用户逻辑 ...return new User(id, "Example User");}// 映射 POST /users@RequestMapping(method = RequestMethod.POST, consumes = MediaType.APPLICATION_JSON_VALUE)@ResponseBodypublic String createUser(@RequestBody User newUser) {// ... 创建用户逻辑 ...return "User created";}// 映射 GET /users?admin=true (需要 admin 参数)@RequestMapping(method = RequestMethod.GET, params = "admin=true")@ResponseBodypublic String getAdminUsers() {// ... 获取管理员用户列表 ...return "List of Admin Users";}// 映射 GET /users (只接受 JSON 请求)@RequestMapping(method = RequestMethod.GET, headers = "Accept=application/json")@ResponseBodypublic String getUsersAcceptingJson() {// ... 获取用户列表 ...return "List of Users (JSON requested)";}
}

@RequestMapping 的变体 (快捷方式注解)

为了提高代码的可读性和简洁性，Spring 提供了针对特定 HTTP 方法的快捷方式注解。它们本质上是 @RequestMapping 预设了 method 属性的别名。

  • @GetMapping: 映射 HTTP GET 请求。等价于 @RequestMapping(method = RequestMethod.GET)。
  • @PostMapping: 映射 HTTP POST 请求。等价于 @RequestMapping(method = RequestMethod.POST)。
  • @PutMapping: 映射 HTTP PUT 请求。等价于 @RequestMapping(method = RequestMethod.PUT)。
  • @DeleteMapping: 映射 HTTP DELETE 请求。等价于 @RequestMapping(method = RequestMethod.DELETE)。
  • @PatchMapping: 映射 HTTP PATCH 请求。等价于 @RequestMapping(method = RequestMethod.PATCH)。

这些快捷注解也支持 @RequestMapping 的 value/path, params, headers, consumes, produces 属性。

使用快捷方式注解的优点：

  1. 更简洁: 代码更短。
  2. 更清晰: 一眼就能看出方法处理的是哪种 HTTP 请求。

示例：使用快捷方式注解 (@RestController 简化)

import org.springframework.web.bind.annotation.*;
import org.springframework.http.MediaType;@RestController // 使用 @RestController，无需在每个方法上加 @ResponseBody
@RequestMapping("/api/items") // 类级别映射
public class ItemController {// 映射 GET /api/items/{itemId}// produces 也可直接写字符串@GetMapping(value = "/{itemId}", produces = MediaType.APPLICATION_JSON_VALUE)public Item getItem(@PathVariable String itemId) {// ... 获取物品逻辑 ...return new Item(itemId, "Sample Item");}// 映射 POST /api/items// consumes 可以指定多个@PostMapping(consumes = {MediaType.APPLICATION_JSON_VALUE, MediaType.APPLICATION_XML_VALUE})public String createItem(@RequestBody Item newItem) {// ... 创建物品逻辑 ...return "Item created: " + newItem.getName();}// 映射 PUT /api/items/{itemId}@PutMapping("/{itemId}")public Item updateItem(@PathVariable String itemId, @RequestBody Item updatedItem) {// ... 更新物品逻辑 ...updatedItem.setId(itemId); // 假设更新成功return updatedItem;}// 映射 DELETE /api/items/{itemId}@DeleteMapping("/{itemId}")public String deleteItem(@PathVariable String itemId) {// ... 删除物品逻辑 ...return "Item deleted: " + itemId;}// 映射 GET /api/items?type=gadget@GetMapping(params = "type=gadget")public String getGadgets() {return "List of Gadgets";}// 映射 GET /api/items (需要特定 Header)@GetMapping(headers = "X-API-Version=2")public String getItemsV2() {return "List of Items (API V2)";}
}// 示例 Pojo
class Item {private String id;private String name;// constructors, getters, setters...public Item(String id, String name) { this.id = id; this.name = name; }public String getId() { return id; }public void setId(String id) { this.id = id; }public String getName() { return name; }public void setName(String name) { this.name = name; }
}class User {private Long id;private String username;// constructors, getters, setters...public User(Long id, String username) { this.id = id; this.username = username; }public Long getId() { return id; }public String getUsername() { return username; }
}

总结

  • @RequestMapping 是基础，可以映射任何 HTTP 方法，并提供最全面的配置选项（path, method, params, headers, consumes, produces）。
  • @GetMapping, @PostMapping, @PutMapping, @DeleteMapping, @PatchMapping 是针对特定 HTTP 方法的快捷方式，使代码更简洁明了，是目前 Spring MVC/WebFlux 开发中的推荐用法。
  • 可以在类级别和方法级别同时使用映射注解，类级别定义基础路径，方法级别定义相对路径。
  • URL 路径通过 value 或 path 属性匹配，支持模式和路径变量 ({var})。
  • HTTP 方法通过 method 属性（在 @RequestMapping 中）或选择特定的快捷注解（如 @GetMapping）来匹配。
  • 请求参数通过 params 属性进行匹配。
  • 请求头通过 headers 属性进行匹配。
  • 请求体类型 (Content-Type) 通过 consumes 属性进行匹配。
  • 可接受的响应类型 (Accept) 通过 produces 属性参与内容协商。

相关文章：

  • 使用 Ziegler-Nichols 法进行 PID 参数整定：实践指南
  • 探索目标检测：边界框与锚框的奥秘
  • FPGA 39 ，FPGA 网络通信协议栈进阶，RGMII、ARP 与 UDP 协议与模块设计（ RGMII、ARP、UDP原理与模块设计 ）
  • VS Code + Linux 远程开发 go
  • Python爬虫（10）Python数据存储实战：基于pymongo的MongoDB开发深度指南
  • 大模型落地难题：如何用LoRA低成本微调企业私有模型？
  • C++程序退出时的对象析构陷阱：深度解析与避坑指南
  • Spring、Spring MVC 与 Spring Boot 的关系与核心用途
  • 【爬虫】案例-获取cbh电影
  • 23G显存可以跑多大尺寸的Qwen3？
  • JavaSE第12篇：接口interface
  • Java练习2
  • 解决 Flutter 在 iOS 真机上构建失败的问题
  • 9.idea中创建springboot项目
  • Javascript 中的继承？如何实现继承？
  • docker-vllm运行大模型
  • 高翔视觉slam中常见的OpenCV和Eigen的几种数据类型的内存布局及分配方式详解
  • 从代码学习深度学习 - 目标检测前置知识(一) PyTorch 版
  • 5.4.2 MVVM例2-用户控件的使用（水在水管中流动的实例）
  • 快速了解Go+rpc
  • 王毅：为改革完善全球治理作出金砖贡献
  • 春暖花开，为何皮肤却闹起了小情绪？
  • 柴德赓、纪庸与叫歇碑
  • 鞍钢矿业党委书记、董事长刘炳宇调任中铝集团副总经理
  • 印巴在克什米尔实控线附近小规模交火，巴防长发出“全面战争”警告
  • 刘非任中共浙江省委常委、杭州市委书记