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

生命周期

Servlet 的生命周期由 Web 容器管理，分为加载、初始化、处理请求和销毁四个阶段。

1. 类加载：容器通过类加载器加载 Servlet 类，首次请求触发或容器启动时预加载。
2. 实例化：确认类加载成功后立即执行，容器中每种 Servlet 类只有一个实例对象。
3. 初始化：调用 init(ServletConfig config) 方法，仅调用一次，用于读取配置和资源。若失败抛出 ServletException。
4. 处理请求：为每个请求创建线程，调用 service() 方法，进而根据 HTTP 类型分发到 doGet 或 doPost。
5. 销毁：容器调用 destroy() 方法，标记实例供垃圾回收。

SpringBoot

Servlet 虽然灵活，但随着复杂度提升，手动编写 Servlet 显得笨重且冗余。Spring 框架通过抽象简化了企业级开发。

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

• Servlet 时代：就像自己烧砖砌墙。你需要亲手烧制每一块砖（编写 Servlet），亲自规划位置（配置 web.xml），还要手动搅拌水泥（处理业务逻辑）。优点是灵活，缺点是繁琐且难以维护。
• Spring 时代：使用预制件和设计图纸。你不再自己烧砖，而是使用工厂提供的标准化组件（Bean）。IoC 容器像一位管家，自动将依赖注入到你需要的地方。DispatcherServlet 如同总大门，统一调度所有请求。
• Spring Boot：彻底消除了配置地狱。基于约定大于配置原则，内置嵌入式容器（如 Tomcat），无需部署 war 包，引入 Starter 即可快速启用功能模块。

Spring Web MVC

概述

Spring Web MVC 是基于 Servlet API 构建的原始 Web 框架，正式名称源自其源模块 spring-webmvc。MVC 模式将应用分为 Model（数据逻辑）、View（界面展示）和 Controller（协调交互）。Spring MVC 则是该模式在 Spring 中的具体化实现。

必需工具

开发过程中通常需要辅助工具：

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

RequestMapping

这是 Spring MVC 最核心的注解之一，用于将 HTTP 请求映射到具体方法。它既可用于类级别提供 URL 前缀，也可用于方法级别指定处理路径。

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

    // 等同于 @GetMapping(value = "/hello")
    @RequestMapping(value = "/hello", method = RequestMethod.GET, produces = "application/json")
    public String hello() {
        return "{\"Hello\" : World}";
    }

    // 接收单个参数，不传参默认为 null
    @RequestMapping("/receiveAge1")
    public String receiveAge1(Integer age) {
        return "接收到参数 age:" + age;
    }

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

    // 接收对象，参数名需与 Java 对象保持一致
    @RequestMapping("/receivePerson")
    public String receivePerson(Person person) {
        return "接收到参数 person:" + person;
    }
}

RequestBody

当需要接收 JSON 格式的请求体数据时，使用 @RequestBody 将其绑定到 Java 对象上。

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

RequestParam

用于从 HTTP 请求中提取参数或查询字符串，并将值绑定到控制器方法的参数上。

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

注意：如果需要接收多个同名参数（如 param=value1&param=value2），直接绑定到 List 类型时需显式添加 @RequestParam 注解。Spring 默认无法推断集合类型的合并需求，必须明确指示。

对于数组类型（如 String[]），Spring 有原生支持，无需额外注解即可正确接收。但如果是接口类型（如 List<String>），直接使用会报错，因为接口不可实例化，必须配合 @RequestParam 并指定具体实现类。

PathVariable

用于从 URL 路径中提取变量值并绑定到方法参数，常用于 RESTful 风格的路径。

@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;
}

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();
}

Controller & ResponseBody & RestController

• @Controller：标记类为 Web 请求处理器，返回视图名称。
• @ResponseBody：指示返回值直接写入 HTTP 响应体，而非渲染视图。
• @RestController：组合注解，结合 @Controller 和 @ResponseBody，所有方法返回值默认作为 HTTP 响应体（JSON/XML），适合构建 API。

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

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

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