Java Web 开发基础：Spring Web MVC 核心注解详解

编写一个继承 HttpServlet 的类，通过重写 doGet、doPost 等方法处理不同请求：

import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebServlet("/method")
public class MethodServlet extends HttpServlet {

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws IOException {
        System.out.println("doPost");
        resp.setContentType("text/html; charset=utf-8");
        resp.getWriter().write("doPost");
    }

    @Override
    protected void doPut(HttpServletRequest req, HttpServletResponse resp) throws IOException {
        System.out.println("doPut");
        resp.setContentType("text/html; charset=utf-8");
        resp.getWriter().write("doPut");
    }

    @Override
    protected void doDelete(HttpServletRequest req, HttpServletResponse resp) throws IOException {
        System.out.println("doDelete");
        resp.setContentType("text/html; charset=utf-8");
        resp.getWriter().write("doDelete");
    }
}

1.2.3 生命周期管理

Servlet 的生命周期由 Web 容器（如 Tomcat）管理，包含加载、初始化、处理请求和销毁四个阶段。

1. 类加载：容器通过类加载器加载 Servlet 类字节码到内存，此时尚未实例化。
2. 实例化：确认加载成功后，容器创建唯一的 Servlet 实例对象。
3. 初始化：调用 init(ServletConfig config) 方法，仅执行一次，用于读取配置或加载资源。若失败则抛出 ServletException。
4. 处理请求：为每个请求创建线程，调用 service() 方法，进而根据 HTTP 类型分发到 doGet 或 doPost。
5. 销毁：容器关闭前调用 destroy() 方法，释放资源并标记垃圾回收。

2. Spring Boot 演进

Servlet 虽然灵活，但随着业务复杂度提升，手动管理 Servlet 显得笨重且冗余。Spring 框架引入了 IoC 容器和 AOP 机制，极大地简化了开发。

我们可以用建造房子来类比这个过程：

第一阶段：Servlet 时代 —— 自己烧砖砌墙

• 目标：搭建能遮风挡雨的 Web 应用。
• 痛点：需要亲手烧制每一块砖（编写 Servlet），亲自规划位置（配置 web.xml），甚至手动搅拌水泥（解析参数、组装 HTML）。代码耦合度高，维护困难，且必须部署到外部 Tomcat。

第二阶段：Spring 时代 —— 预制件与设计图纸

• 创新：引入 IoC 容器作为'管家'，不再手动 new 对象，而是通过 @Autowired 声明依赖，让容器自动装配 Bean。
• 流程：所有请求先到达总大门（DispatcherServlet），由接待员调度到对应的房间（Controller 方法）。开发者只需关注业务逻辑，无需关心请求入口。
• 优势：解耦、专业化（AOP 统一处理日志事务）、效率高。但早期 Spring 配置较为复杂。

第三阶段：Spring Boot —— 拎包入住 Spring Boot 基于 Spring Framework 设计，彻底消除了配置地狱。

• 约定大于配置：提供合理的默认配置。
• Start 机制：通过 Starter 依赖管理，一键启用功能模块。
• 嵌入式容器：内置 Tomcat，无需打包 war 部署，直接运行 jar 即可启动应用。

3. Spring Web MVC 实战

3.1 概述

Spring Web MVC 是基于 Servlet API 构建的原始 Web 框架，正式名称源自 spring-webmvc 模块。它遵循经典的 MVC 模式：

• Model：处理数据与业务规则。
• View：负责数据展示。
• Controller：接收输入并协调 Model 与 View。

3.2 必需工具

开发过程中，推荐使用以下工具辅助调试：

• Postman：用于 API 开发与测试，支持发送 HTTP 请求及管理历史。
• Fiddler：网络调试代理，监控分析 HTTP/HTTPS 流量，支持修改与重放请求。

3.3 RequestMapping 核心用法

这是最基础的注解，用于将 HTTP 请求映射到具体方法。既可用于类（统一 URL 前缀），也可用于方法（指定路径与方式）。

@RequestMapping("/HelloController")
@RestController
public class HelloController {

    // GET 请求示例，返回 JSON 格式
    @RequestMapping(value = "/hello", method = RequestMethod.GET, produces = "application/json")
    public String hello() {
        return "{\"Hello\" : World}";
    }

    // 单个参数绑定
    @RequestMapping("/receiveAge1")
    public String receiveAge1(Integer age) {
        return "接收到参数 age:" + age;
    }

    // 数组参数绑定
    @RequestMapping("/receiveArray")
    public String receiveArray(String[] array) {
        return "接收到参数 array:" + Arrays.toString(array);
    }

    // 对象参数绑定（需保证参数名与属性一致）
    @RequestMapping("/receivePerson")
    public String receivePerson(Person person) {
        return "接收到参数 person:" + person;
    }
}

3.4 RequestBody 与 JSON 绑定

当请求体包含 JSON 数据时，使用 @RequestBody 将其自动绑定到 Java 对象。

@RequestMapping("/receivePerson")
public String receivePerson(@RequestBody Person person) {
    return "接收到参数 person:" + person;
}

3.5 RequestParam 参数提取

用于从查询字符串中提取参数。默认参数为必传，可通过 required = false 设置为可选。

@RequestMapping("/receiveRename")
public String receiveRename(@RequestParam(value = "name", required = false) String userName) {
    return "接收到参数 name:" + userName;
}

注意集合类型的处理差异：

• 数组 (String[])：Spring 原生支持，无需额外注解即可接收多个同名参数。
• List/ArrayList：默认无法推断是否合并参数，必须显式添加 @RequestParam。
• 接口类型 (List)：直接使用会报错 IllegalStateException，因为接口不可实例化，必须配合 @RequestParam 或使用具体实现类。

// 正确写法
@RequestMapping("/receiveList2")
public String receiveList2(@RequestParam(required = false) ArrayList<String> list) {
    return "接收到参数 list:" + list;
}

3.6 PathVariable 路径变量

用于从 URL 路径中提取动态值。

@RequestMapping("/receivePath/{article}/{blog}")
public String receivePath(
    @PathVariable(value = "article", required = false) Integer title,
    @PathVariable(value = "blog", required = false) String content
) {
    return "接收到参数 article:" + title + " blog:" + content;
}

3.7 RequestPart 文件上传

处理 multipart/form-data 类型数据，常用于文件上传场景。

@RequestMapping("/receiveFile")
public String receiveFile(
    @RequestPart(value = "file", required = false) MultipartFile imgFile,
    @RequestParam(value = "userName", required = false) String name
) {
    return "用户:" + name + ",接收到文件:" + imgFile.getOriginalFilename();
}

3.8 Controller 与响应处理

• @Controller：标记类为控制器，返回值通常被视为视图名称。
• @ResponseBody：指示返回值直接写入响应体，而非渲染视图。
• @RestController：组合注解，等同于 @Controller + @ResponseBody，所有方法默认返回数据（JSON/XML），适合 RESTful API 开发。

@RequestMapping("/ControllerResponse")
@Controller
public class ControllerResponse {

    // 返回视图
    @RequestMapping("/HTMLView")
    public String HTMLView() {
        return "/show.html";
    }

    // 返回数据
    @RequestMapping("/HTMLData")
    @ResponseBody
    public String HTMLData() {
        return "/show.html";
    }
}