Spring Web MVC 入门指南：从概念到实践

2. @RestController 注解介绍

@RestController 就像给控制器类贴了一个特殊标签，告诉 Spring 框架：这个类里的方法返回的数据直接发给前端，不需要经过视图解析器找页面。

如果不加这个注解会怎样？

• 使用普通的 @Controller，方法返回的是'页面地址'，系统会尝试渲染视图。
• 不加任何控制器注解，类只是一个普通类，接口无法被识别为 Controller。

3. @RequestMapping 注解详解

@RequestMapping 用于将特定的 HTTP 请求映射到对应的处理方法。路径中的 /hello 表示调用该路径下的方法代码。路径前是否加斜杠通常没有影响，但建议加上以保持规范。

它既可以用在类上，也可以用在方法上，组合方式决定了最终的路径结构。

(1) 只用在类上

相当于'只给文件夹起名，不给文件起名'。

@RestController
@RequestMapping("/sayhello")
public class HelloController {
    public String say() {
        return "hello";
    }
}

此时访问路径需包含类上的路径，如 /sayhello/say（假设方法名自动映射）。

(2) 只用在方法上

相当于'只给文件起名，不给文件夹起名'。

@RestController
public class HelloController {
    @RequestMapping("/sayhello")
    public String say() {
        return "hello";
    }
}

系统会搜索所有 Controller 来查找这个文件名。如果存在重复文件名，可能会发生冲突报错。

(3) 用在类和方法上

相当于'给文件夹和文件都取名'，定位最精确。

@RestController
@RequestMapping("/sayhello")
public class HelloController {
    @RequestMapping("/hello1")
    public String say1() {
        return "hello1";
    }
    @RequestMapping("/hello2")
    public String say2() {
        return "hello2";
    }
}

访问路径分别为 /sayhello/hello1 和 /sayhello/hello2。

请求方法限制

默认情况下，@RequestMapping 支持 GET 和 POST。如果只想支持其中一种，可以使用 method 属性或专用注解。

只用 GET：

// 写法 1
@RequestMapping(value = "/2", method = RequestMethod.GET)
public Integer num2() { return 2; }
// 写法 2（推荐）
@GetMapping("/3")
public Integer num3() { return 3; }

只用 POST：

// 写法 1
@RequestMapping(value = "/4", method = RequestMethod.POST)
public Integer num4() { return 4; }
// 写法 2（推荐）
@PostMapping("/5")
public Integer num5() { return 5; }

三、Postman 接口测试

1. 什么是 Postman？

Postman 是一款广泛用于 API 开发、测试和调试的工具。它的核心价值在于高效便捷：图形化界面填参即可发送请求，无需写代码；支持各种 HTTP 方法和数据格式；还能保存历史、生成文档甚至自动化测试。

2. 传参方式介绍

在 Postman 中，主要有以下几种传参形式：

• Query String（查询字符串）：普通传参，直接在 URL 后面拼接 ?key=value。
• form-data：完整表示为 multipart/form-data，通常用于提交图片、文件等二进制数据。
• x-www-form-urlencoded：对应 Content-Type 为 application/x-www-form-urlencoded，表单键值对提交。
• Raw：可以上传任意格式的文本，如 JSON、XML、HTML 等。

3. 传递参数实战

(1) 单个参数

后端代码示例：

@RestController
@RequestMapping("/request")
public class RequestController {
    @RequestMapping("/1")
    public String method(String string) {
        return "接收单个参数:" + string;
    }
}

注意：参数名必须一致，否则无法接收。如果是基本类型（如 int），不传值不会报错；如果是引用类型（如 Integer），不传值则为 null。

(2) 多个参数

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

(3) 对象参数

可以直接传递自定义对象，Spring 会自动进行属性绑定。

@RequestMapping("/5")
public String method(User user) {
    return "接收对象参数：" + user.toString();
}

// User 类定义
@RestController
@RequestMapping("/User")
public class User {
    private String name;
    private int password;
    private int age;
    // getter/setter 省略...
    @Override
    public String toString() {
        return "User{name='" + name + "', password=" + password + ", age=" + age + '}';
    }
}

(4) 参数重命名：@RequestParam

如果前后端参数命名不一致，可以使用 @RequestParam 指定映射关系。

// 将前端传来的 str 映射到后端 s
@RequestMapping("/6")
public String method(@RequestParam("str") String s) {
    return "接收参数：" + s;
}

默认情况下 required=true，如果不传参数会报错。若允许不传，可设置 required=false：

@RequestMapping("/7")
public String method(@RequestParam(value = "str", required = false) String s) {
    return "接收参数：" + s;
}

(5) 数组与集合

传递数组：

@RequestMapping("/8")
public String method(String[] s) {
    return Arrays.toString(s);
}

传递集合： 接收 List 类型时，需要显式开启'允许多值'模式，否则 Spring 可能无法正确解析。

@RequestMapping("/9")
public List<Integer> method(@RequestParam List<Integer> num) {
    return num;
}