Spring Boot 入门：Spring Web MVC 核心概念与实战

实战：请求映射与参数处理

1. 建立连接

使用 @RequestMapping 注解来定义 URL 路由。它可以放在类上，也可以放在方法上。

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

如果需要在类级别统一路径，可以这样写：

@RequestMapping("/basic")
@Controller
public class BasicController {
    // 此时完整路径为 /basic/hello
    @RequestMapping("/hello")
    @ResponseBody
    public String hello(String name) {
        return "接受到的参数是：" + name;
    }
}

2. 请求方式控制

默认情况下 @RequestMapping 支持所有 HTTP 方法。如果需要限制，可以使用 method 属性或专用注解如 @GetMapping。

@GetMapping("/hello")
@ResponseBody
public String hello(Integer age) {
    if (age == null) {
        age = 0;
    }
    return "接受到的参数是：" + age;
}

3. 参数传递细节

基本类型与空值处理

基本数据类型（如 int）不能为 null。如果不传参会报错，建议改用包装类（如 Integer）或设置默认值。

// 推荐方式：使用包装类并在代码中判断
@GetMapping("/hello")
@ResponseBody
public String hello(Integer age) {
    return "接受到的参数是：" + age;
}

单个与多个参数

引用类型可以直接接收，多个参数按名称匹配即可，顺序不影响。

@RequestMapping("/hello")
@ResponseBody
public String hello(String name, Integer age) {
    return "name=" + name + ", age=" + age;
}

对象绑定

如果请求参数名与对象的字段名一致，Spring 会自动封装成对象。

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

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

数组与集合

浏览器发送相同参数名多次会被封装为数组。对于 List 类型，建议使用 @RequestParam 显式声明。

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

参数重命名

当请求参数名与方法参数名不一致时，使用 @RequestParam("请求名") 进行映射。

@RequestMapping("/hello")
@ResponseBody
public String hello(@RequestParam("name") String username) {
    return "接受到的 name 参数是：" + username;
}

如果希望参数可选，需设置 required=false。

@RequestMapping("/hello")
@ResponseBody
public String hello(@RequestParam(value = "name", required = false) String username) {
    return "接受到的 name 参数是：" + username;
}