Spring Web MVC 入门：从概念到实战（上）

@RestController 注解相当于给控制器类贴了一个特殊标签，告诉 Spring 框架：这个类里的方法是用来返回数据的。它让控制器方法直接返回的内容作为响应内容发给前端，无需再经过视图解析流程。

如果不加 @RestController 会怎样？

• 使用 @Controller：方法返回的是'页面地址'，需要配合视图解析器。
• 不加任何注解：类只是一个普通类，接口无法被识别为控制器。

3. @RequestMapping 注解详解

@RequestMapping 是 Spring 框架中非常重要的注解，用于将特定的 HTTP 请求映射到对应的处理方法。路径中的 /hello 表示调用该路径下的方法代码。建议路径前加上 /，虽然不加也能运行，但规范起见最好加上。

@RequestMapping 既可以用在类上，也可以用在方法上：

1. @RequestMapping 只用在类上

相当于'只给文件夹起名，不给文件起名'。系统找到了文件夹，但不知道具体是哪个文件。

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

2. @RequestMapping 只用在方法上

相当于'只给文件起名，不给文件夹起名'。系统不知道是哪个文件夹的文件，会搜索所有文件夹来查找。

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

如果两个方法路径相同会发生冲突报错，因此通常建议结合使用。

3. @RequestMapping 用在类和方法上

相当于给文件夹和文件都取名，定位更精准，不易报错。

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

请求方式控制： @RequestMapping 默认支持 GET 和 POST。如果只想支持其中一种，可以使用 method 属性或专用注解。

// 只支持 GET
@GetMapping("/3")
public Integer num3() {
    return 3;
}

// 只支持 POST
@PostMapping("/5")
public Integer num5() {
    return 5;
}

三、Postman 接口测试

1. 什么是 Postman？

Postman 是一款广泛用于 API 开发、测试和调试的工具。其核心价值体现在高效、便捷地处理 API 相关工作。

核心优势：

• 调试简单：图形化界面，填好参数即可发送请求，无需写代码。
• 功能全面：支持各种 HTTP 请求方法和数据格式。
• 协作方便：可分组管理 API，共享给团队，支持多环境切换。
• 自动化测试：可编写脚本验证响应，批量运行测试并生成报告。

2. 传参介绍

在 Postman 中，常见的传参方式有以下几种：

1. 查询字符串（Query Params）：通过 URL 参数传递，如 ?name=abc。
2. form-data (multipart/form-data)：表单提交数据，通常用于提交图片或文件。
3. x-www-form-urlencoded：标准表单提交，对应 Content-Type 为 application/x-www-form-urlencoded。
4. Raw：上传任意格式的文本，如 text、JavaScript、JSON、HTML、XML。

3. 传递参数实战

1. 传递单个参数

后端参数名需与前端一致，否则无法接收。

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

基本类型与引用类型的区别：

• 引用类型（如 Integer）：若不传值，赋值为 null，不会报错。
• 基本类型（如 int）：若不传值，可能会发生类型转换异常或报错。

2. 传递多个参数

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

3. 传递对象

若前后端参数命名不一致，可使用 @RequestParam 进行重命名。

// 重命名为 str
@RequestMapping("/6")
public String method(@RequestParam("str") String s) {
    return "接收参数：" + s;
}

注意：使用 @RequestParam 时参数默认为必传，若不需要必填，可设置 required = false。

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

4. 传递数组

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

5. 传递集合

接收 List 类型时，通常需要开启'允许多值'模式，否则 Spring 可能无法正确解析。

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