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

如果不加该注解会怎样？

• 使用 @Controller：方法返回的是页面地址（视图名）。
• 不加任何注解：类被视为普通类，接口无法访问。

3. @RequestMapping 注解

@RequestMapping 用于将特定的 HTTP 请求映射到对应的处理方法。括号内的路径表示调用该方法。建议路径前加上 /，虽无影响但更规范。

使用位置说明：

1. 只用在类上

相当于'只给文件夹起名'，为该类下的所有方法提供公共路径前缀。

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

此时访问路径为 /sayhello/say（假设方法也有映射），若方法无映射则可能报错或匹配不到具体文件。

2. 只用在方法上

相当于'只给文件起名'，直接定位到具体方法。

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

系统会搜索所有控制器查找该文件名。若存在重复文件名，会发生冲突报错。

3. 用在类和方法上

相当于'文件夹 + 文件'都取名，定位最精准。

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

请求方法支持： 默认情况下，@RequestMapping 支持 GET 和 POST。

• 限制为 GET：

  @GetMapping("/3")
  public Integer num3() { return 3; }
  // 或
  @RequestMapping(value = "/2", method = RequestMethod.GET)
  public Integer num2() { return 2; }
  

• 限制为 POST：

  @PostMapping("/5")
  public Integer num5() { return 5; }
  // 或
  @RequestMapping(value = "/4", method = RequestMethod.POST)
  public Integer num4() { return 4; }
  

三、Postman 工具

1. 什么是 Postman？

Postman 是广泛用于 API 开发、测试和调试的工具。核心价值在于高效便捷：

• 调试简单：图形化界面填参即可发送请求，直观展示响应。
• 功能全面：支持各种 HTTP 方法和数据格式。
• 协作方便：支持分组管理、环境切换及团队共享。
• 自动化测试：可编写脚本验证响应，集成 CI/CD 流程。

2. 关于 API

API（Application Programming Interface）是不同软件间交互的规则集合。就像网购下单，你只需知道如何操作，无需了解后台具体流程。API 就是那个'下单规则'。

3. 传参介绍

1. 普通传参（查询字符串）

直接在 URL 后追加参数，如 ?key=value。

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。

4. 传递参数实战

1. 单个参数

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

注意：参数名需一致，否则无法接收。基本类型与引用类型区别在于未传值时，引用类型为 null，基本类型可能报错或为空。

2. 多个参数

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

3. 传递对象

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

@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 + '}';
    }
}

参数重命名： 如果前后端参数名不一致，可使用 @RequestParam 重命名。

// 将请求参数 str 映射到变量 s
@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 类型时，需开启'允许多值'模式。

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