Spring Web MVC 入门：从概念到实战的参数处理指南

2.3 深入理解 MVC 与 Spring MVC

Spring Boot 帮助我们快速搭建项目，而 Spring MVC 是项目中负责 Web 交互的模块。两者有交集，但职责不同。

3. Spring MVC 实战要点

作为 Web 框架，用户输入 URL 后，Spring MVC 感知请求并响应。学习重点主要在于以下三个方面：

1. 建立连接：URL 访问能调用到 Java 程序。
2. 请求：获取用户传递的参数。
3. 响应：将业务执行结果返回给用户。

掌握了这三点，基本就掌握了 Spring MVC 的核心。

3.1 环境准备

创建 Spring MVC 项目与 Spring Boot 类似，关键是勾选 Spring Web 模块。

3.2 路由映射

在 Spring MVC 中，使用 @RequestMapping 注解来实现 URL 路由映射。它可以放在类上修饰类，也可以放在方法上修饰方法。

创建一个 Controller 示例：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class BasicController {

    // http://127.0.0.1:8080/hello?name=lisi
    @RequestMapping("/hello")
    @ResponseBody
    public String hello(@RequestParam(name = "name", defaultValue = "unknown user") String name) {
        return "Hello " + name;
    }
}

运行主程序后，访问 http://127.0.0.1:8080/hello 即可看到效果。

3.2.1 路径规则

如果在类上也添加了 @RequestMapping("/basic")，那么完整路径就会变成 /basic/hello。这有助于组织代码结构。

3.2.2 请求方法

默认情况下，@RequestMapping 支持所有 HTTP 方法。如果只想接收 GET 请求，可以使用 @GetMapping；POST 则用 @PostMapping。这样可以在 Postman 测试时更精准地控制请求方式。

3.3 参数接收详解

后端开发无需过度关注参数如何传递，重点是后端如何接收。我们主要通过浏览器或 Postman 模拟传递。

3.3.1 无参情况

如果不传参且没有设置默认值，引用类型会默认为 null，基本数据类型则会报错。例如 int age 未传参时会抛出异常，因为基本类型不能为 null。

解决办法有两种：

1. 使用包装类 Integer，它可以接受 null。
2. 使用 @RequestParam 的 defaultValue 属性。

@GetMapping("/hello")
@ResponseBody
public String hello(@RequestParam(value = "age", defaultValue = "0") int age) {
    return "年龄是：" + age;
}

3.3.2 单参数与多参数

对于字符串等引用类型，直接在方法参数中声明即可。多个参数时，顺序不影响接收结果。

@RequestMapping("/hello")
@ResponseBody
public String hello(String name, Integer age) {
    return "姓名：" + name + ", 年龄：" + age;
}

访问 ?name=zhangsan&age=20 即可正常接收。

3.3.3 对象封装

Spring MVC 支持自动将参数封装成对象。只要参数名与对象的字段名一致，就可以直接接收。

public class User {
    private String name;
    private Integer age;
    // getter/setter 省略
}

@RequestMapping("/save_user")
@ResponseBody
public String saveUser(User u) {
    return u.toString();
}

访问 ?name=lisi&age=20 会自动映射到 User 对象。

3.3.4 数组与集合

同一个参数赋值多次时，浏览器会将其封装为数组。

@RequestMapping("/hello")
@ResponseBody
public String hello(String[] arrayName) {
    return Arrays.toString(arrayName);
}

对于集合（如 List<String>），直接接收可能会报错，因为列表无法直接匹配单个构造函数。此时需配合 @RequestParam 注解。

@RequestMapping("/hello")
@ResponseBody
public String hello(@RequestParam List<String> listName) {
    return listName.toString();
}

或者在 URL 中使用重复参数名：?listName=a&listName=b。

3.3.5 参数重命名

有时候前端传来的参数名与后端变量名不一致，可以使用 @RequestParam("name") 指定映射关系。

@RequestMapping("/hello")
@ResponseBody
public String hello(@RequestParam("name") String username) {
    return "收到：" + username;
}

如果参数非必填，记得设置 required = false，否则缺少该参数会直接报错。

@RequestParam(value = "name", required = false) String username