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

2.@RestController 注解的介绍

@RestController 注解就像给控制器类贴一个特殊标签，告诉 Spring 框架：这个类里的方法是传给前端的返回数据。让控制器里的方法直接返回的东西当成响应内容发给前端，不用再走'找页面'流程。 如果不控制器加@RestController 注解会访问页面会怎么样？ 结果如下： @RestController 的核心作用是'让方法返回数据' 如果没有@RestController，通常会用普通的@Controller 注解，或者干脆不加控制器注解，那么类就不会被识别为控制器。

• 用@Controller，方法返回的是'页面地址'
• 什么控制器注解都不加，那么类只是一个普通类，接口无法访问。

3.@RequestMapping 注解

定义：@RequestMapping 是 Spring 框架中一个非常重要的注解，用于将特定的 Http 请求方法映射带对应的处理方法。@RequestMapping（"/hello"）中里面的/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";
    }
}

相当于系统不知道是哪个文件夹的文件，但是会搜索所有文件夹来查找这个文件，直接通过文件名来定位。 那么如果出现相同的文件名呢？会怎么样，我们来试一下。

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

系统只知道文件名，但是有两个相同的文件名，会出现路径重复的问题，发生报错现象。

3.@RequestMapping 用在类和方法上（相当于给文件夹和文件都取名）

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

相当于给文件夹和文件都取名，可以进行具体的定位，不容易发生报错。 查看 RestMapping 是否即支持 Post 和 Get

@RestController
@RequestMapping("/number")
public class Rest {
    //即支持 post，又支持 get
    @RequestMapping("/1")
    public Integer num1() {
        return 1;
    }
}

另一种写法

@RequestMapping(value = "6",method = {RequestMethod.GET,RequestMethod.POST})
public Integer num6(){
    return 6;
}

• RestMapping 即支持 Post 和 Get 如果我只要只能用 get 或者 Post 其中一种呢？应该怎么写 只用 get

// 只支持 get
//写法 1
@RequestMapping(value="/2",method = RequestMethod.GET)
public Integer num2(){ return 2; }
//写法 2
@GetMapping("/3")
public Integer num3(){ return 3; }

只请求 Post

//只请求 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 开发、测试和调试的工具，被开发者、测试工具等广泛使用，其核心价值体现在高效、便捷的处理 API 相关工作。 Post 是 API 开发调试的高效工具，核心优势：

• 调试简单：图形化界面，填好参数就能发送请求，不用写代码，响应结果直观展示。
• 功能全面：支持各种 HTTP 请求方法和数据格式。
• 协作方便：可将 API 分组管理，共享给团队；多环境一键切换，不用重复配置。
• 能自动化测试：可写脚本验证响应，批量运行测试并生成报告，还能集成开发流程中自动检测问题。
• 实用小工具：保存请求历史、自动生成 API 文档等，提升效率。

2.关于 API

API（Application Programming Interface，应用程序编程接口）是不同软件之间进行交互的一套规则、协议和工具的集合，他规定了一方如何向另一方请求服务或数据，以及另一方如何响应。API 就像两个软件之间的'桥梁'或'服务员'，让他们能按照统一的方式沟通，而无需了解对方的内部工作原理。 就像我们去网购的时候，我们直接对自己想要的东西直接下单购买即可，不用了解其内部具体流程是怎么样执行的，最后他都会把你要的东西给到你。这里'下单的流程'就是 API 规则。 界面介绍

3.传参介绍

1.普通传参：通过查询字符串来传参

2.form-data(完整表示为：multipart/form-data)

表单提交数据，在 form 标签中加上 enctyped='multipart/form-data',通常用于提交图片/文件。对应 Content-type：multipart/form-data

3.x-www-form-urlencoded

form 表单：对应 Content-type：application/x-www-form-urlencoded

4.raw:可以上传任意格式的文本，比如：text、JavaScript、json、html、xml

4.传递参数

1.传递单个参数

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/request")
public class RequestController {
    @RequestMapping("/1")
    public String method(String string){
        return "接收单个参数:"+string;
    }
}

• 接收时，参数名要一致，否则无法接收到参数 如果接受的参数基本类型不对应，会发生报错现象 基本类型和引用类型传参的区别

@RequestMapping("/2")
public String method2(Integer i){
    return "接收单个参数:"+i;
}
@RequestMapping("/3")
public String method3(int j){
    return "接收单个参数:"+j;
}

• 引用类型：传参时，若不传值，会赋值为 null，不会发生报错现象
• 基本类型：传参时，若不传值，不会发生报错现象

2.传递多个参数

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

3.传递对象

@RequestMapping("/5")
public String method3(User user){
    return "接收对象参数："+user.toString();
}
@RestController
@RequestMapping("/User")
public class User {
    private String name;
    private int password;
    private int age;
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public int getPassword() {
        return password;
    }
    public void setPassword(int password) {
        this.password = password;
    }
    public int getAge() {
        return age;
    }
    public void setAge(int age) {
        this.age = age;
    }
    @Override
    public String toString() {
        return "User{" + "name='" + name + '\'' + ", password=" + password + ", age=" + age + '}';
    }
}

后端参数重命名：@RequestParam 如果前后端参数命名不一致，可能会出接收不到的情况，这时候我们可以使用@RequestParam 来重命名前后端参数。

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

• 使用@RequestParam 重命名时参数就成了必传参数，否则将会报错
• 使用@RequestParam 时，就不能再使用原来的前后端的参数名 如果真的不想要传参数怎么办？ 看一下@RequestParam 的源码 其默认参数为 true，所以一定要传参数，我们将其改为 false 就好了

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

4.传递数组

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

5.传递集合

传递集合需要使用@RequestParam 用于接收单个请求参数。如果要接收 List 类型，需要显示开启'允许多值'模式，否则 Spring 无法解析

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