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

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

路径规则

@RequestMapping 可放在类或方法上。若放在类上，路径会拼接：

@RequestMapping("/basic")
@Controller
public class BasicController {
    // ... 方法同上
}

此时访问路径变为 /basic/hello。

4.2 请求方式限定

默认情况下 @RequestMapping 支持所有 HTTP 方法。若需限制，可使用 method 属性：

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

此时仅允许 GET 请求，Postman 测试 POST 时会报错。

4.3 参数接收详解

无参数情况

引用类型不传参默认为 null，基本类型则抛出异常。建议优先使用包装类或设置默认值：

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

单个与多个参数

直接定义方法参数即可自动绑定：

@GetMapping("/hello")
@ResponseBody
public String hello(String name, Integer age) {
    return "姓名：" + name + ", 年龄：" + 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();
}

访问 ?name=lisi&age=20 即可成功绑定。

数组与集合

同一个参数多次传递会被封装为数组：

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

对于 List 类型，直接使用可能报错，需配合 @RequestParam：

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

参数重命名

若请求参数名与方法参数名不一致，需使用 @RequestParam 指定：

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

若希望参数可选，可设置 required = false。

通过以上配置，我们完成了从 URL 访问到参数接收的完整流程。在实际开发中，结合 Postman 等工具进行测试是验证接口正确性的关键步骤。