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

代码实现

使用 @WebServlet 注解简化配置，继承 HttpServlet 并重写对应方法：

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() 方法，标记实例供垃圾回收。

SpringBoot

随着应用复杂度提升，直接使用 Servlet 显得笨重。Spring 框架通过抽象简化了企业级开发。

演进对比：

• Servlet 时代：类似自己烧砖砌墙。需手动编写每个 Servlet，在 web.xml 中配置映射，手动解析参数。高度灵活但极其繁琐，难以维护。
• Spring 时代：使用预制件和设计图纸。通过 IoC 容器管理 Bean，利用依赖注入（DI）解耦对象。AOP 像装修队一样非侵入式地处理日志、事务。但配置复杂。
• Spring Boot：基于 Spring Framework 4，发布于 2014 年。显著减少配置工作量，消除配置地狱。
  • 约定大于配置：提供默认配置。
  • Start 机制：依赖管理机制，引入 Starter 即可启用功能模块。
  • 嵌入式容器：内置 Tomcat，无需部署 war 包，直接运行启动。

Spring Web MVC

概述

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

必需工具

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

RequestMapping

最核心的注解之一，用于将 HTTP 请求映射到具体方法。支持类和方法级别。

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

RequestBody

将 HTTP 请求体中的 JSON 数据绑定到 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;
}

注意：

• 接收多个同名参数时，集合类型需显式添加 @RequestParam。
• 数组类型（如 String[]）无需注解即可自动接收。
• 接口类型（如 List<String>）不能直接作为参数，必须配合 @RequestParam 或使用具体实现类。

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 & ResponseBody & RestController

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

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

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

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