Spring Web MVC 核心注解与请求映射实战

Spring Web MVC 简介

Spring Web MVC 是 Spring 框架中最基础的 Web 模块，基于 Servlet API 构建。虽然正式名称叫 Spring Web MVC，但大家更习惯叫它 Spring MVC。它与 Spring WebFlux（反应式栈）并行存在，本章主要聚焦于传统的 MVC 模型。

MVC 架构模式

MVC 将系统分为三部分：

• Model（模型）：处理业务逻辑和数据的核心部分。
• View（视图）：负责与浏览器交互，展示数据。
• Controller（控制器）：分发器，决定请求由哪个模型处理，以及处理后返回哪个视图。

核心注解：@RequestMapping

在 Spring Web MVC 中，@RequestMapping 是最常用的注解之一，用于注册接口的路由映射。简单来说，当用户访问特定 URL 时，Spring 会将其对应到某个类的某个方法上。

路径映射规则

该注解既可以修饰类，也可以修饰方法。如果同时使用，访问地址是'类路径 + 方法路径'。

@RestController
@RequestMapping("/user")
public class UserController {
    @RequestMapping("/hello")
    public String hello() {
        return "hello Spring";
    }
}

此时访问 http://127.0.0.1:8080/user/hello 即可触发 hello 方法。

提示：URL 路径最前面加不加斜杠 / 都可以，Spring 启动时会做兼容处理，但为了规范，建议统一加上。

指定请求方法类型

@RequestMapping 支持所有 HTTP 请求，但我们通常需要明确指定方法类型，比如只接收 POST 请求。

方式一：显式设置 method 属性 可以在注解中通过 method 参数限定请求方式，支持数组形式。

@RestController
@RequestMapping("/user")
public class UserController {
    @RequestMapping(value = "/hello", method = RequestMethod.POST)
    public String  {
         ;
    }
}