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

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

生命周期管理

Servlet 的生命周期由 Web 容器管理，包含加载、初始化、处理请求和销毁四个阶段。开发者通过重写特定方法实现自定义逻辑。

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

Spring Boot 演进

Servlet 是 Java EE 处理 Web 请求的核心，但随着复杂度提升，直接编写 Servlet 显得笨重且冗余。Spring 框架通过抽象简化了企业级开发。

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

• Servlet 时代：自己烧砖砌墙。你需要亲手制作每一块砖（编写 Servlet），规划每块砖的位置（配置 web.xml），手动搅拌水泥（处理业务）。虽然灵活，但极其繁琐，耦合度高，维护困难。
• Spring 时代：使用预制件和设计图纸。你不再亲自'砌砖'，而是告诉管家（IoC 容器）你需要什么（依赖注入）。总大门（DispatcherServlet）统一接待访客，调度专业房间（Controller）处理。AOP 像装修队一样非侵入式地统一安装中央空调（日志、事务）。
• Spring Boot：彻底消除配置地狱。基于 Spring Framework 设计，强调约定大于配置。引入 Start 机制管理依赖，内置嵌入式容器（如 Tomcat），无需部署 war 包即可直接运行。

Spring Web MVC 实战

概述

Spring Web MVC 是基于 Servlet API 构建的原始 Web 框架，正式名称源自源模块 spring-webmvc。MVC 模式将应用分为 Model（数据）、View（视图）、Controller（控制），Spring MVC 在此基础上扩展以适应现代 Web 需求。

必备工具

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

核心注解详解

RequestMapping

这是最基础的注解，用于将 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}";
    }

    // 参数接收示例
    @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;
    }
}

RequestBody

当请求体包含 JSON 数据时，使用此注解将其绑定到 Java 对象。

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

RequestParam

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

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

注意点：

• 接收多个同名参数时，集合类型（如 ArrayList）必须显式添加 @RequestParam 注解，否则 Spring 无法推断合并逻辑。
• 数组类型（如 String[]）无需注解即可自动绑定。
• 接口类型（如 List<String>）不能直接使用，会报错 IllegalStateException，因为接口不可实例化，需配合注解或使用具体实现类。

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

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 相关注解

• @Controller：标记类为 Web 处理器，返回视图名。
• @ResponseBody：指示返回值直接写入响应体，而非渲染视图。
• @RestController：组合注解，等价于 @Controller + @ResponseBody，所有方法返回值默认作为 HTTP 响应体（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";
    }
}