当前位置：首页 > news >正文

Spring MVC（一）

news 2026/1/16 18:03:39

@RestController

@RestController 是由 @Controller 和 @ResponseBody 两个注解构成的。

Spring 启动的时候会扫描所有包含 @Controller 或者 @RestController 注解的类，创建出对外的接口，这样外界就可以从这里与服务器实现交互，如果没有这个注解， Spring 就不会扫描该类，外界也就无法找到这个类了。

因为 Spring 项目包含的类很多，不仅仅有自定义的类，还有标准库第三方库的类，为了能快速启动 Spring 项目，所以 Spring 只会扫描所有包含 @Controller 或者 @RestController 注解的类，并创建其对外的接口

举个例子：下面的类即使使用了 @RequestMapping 注解，客户端在访问的时候得到却是 404 （页面不存在）的响应，就因为这个类没有使用 @Controller 或者 @RestController 注解

在这里插入图片描述

404 页面可以由程序员自行设定，例如 B站的 404 页面就很精美，Spring 的 404 页面有一个默认的页面，上面就是默认的 404 页面

@Controller 和 @ReponseBody的区别：
@Controller 是用来返回页面的，例如 html
@ResponseBody 是用来返回数据的。

如果你在类上面使用了 @Controller ，在类里的方法的返回值就是页面，例如下面所示：返回一个 html 页面，返回值的参数类型虽然是 String，但是Spring 会将返回值作为 html 来解析。

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body><h1>我是一级标题</h1>
</body>
</html>

@RequestMapping("/RespController")
@Controller
public class ResponseController {@RequestMapping("r1")public String returnHTML() {return "/index.html";}
}

返回页面的时候，返回值填写的是该页面相对于 static 这个包的路径

在这里插入图片描述

在这里插入图片描述
通过抓包我们可以看出响应的数据类型为 text/html

在这里插入图片描述

由于 @Controller 注解的类的方法一般返回的是页面，如果你想要返回数据的话，可以在方法上加上注解 @ResponseBody

    @ResponseBody@RequestMapping("/r2")public String returnText() {return "/index.html";}

在这里插入图片描述

注解源码解析

@RestController 源码解析：

在这里插入图片描述

Target 是指这个注解可以作用的位置，ElementType 里面包含很多枚举类型，其中 TYE 指类，说明 @RestController 是一个类注解，作用在类上。

Retention 指注解可以存活到哪个事时间段里：我们编写的Java 代码要运行的时候，首先是由源代码（SOURCE）编译为 .class 文件（CLASS），最后才进入运行阶段（RUNTIME）
@RestController 可以活到 RUNTIME，说明 @RestController 在代码运行阶段依旧存在

在这里插入图片描述

接着下面就是我们熟知的 @Controller 和 @ResponseBody 两个注解，这也说明了 @RestController 是由 @Controller 和 @ResponseBody 两个注解构成的。

Controller 注解源码解析：
在这里插入图片描述

首先这是一个类注解，只能作用在类上，不能作用在方法上

其可以存活在代码运行阶段

@ResponseBody 注解源码解析：

在这里插入图片描述

即是一个类注解，也是一个方法注解

其可以存活在代码运行阶段

@ResquestMapping

@RequestMapping 是用来注册接口的路由映射的。

简单来说，@RequestController 是用来开辟一个外界能找到的路径，@RestController 或者 @Controller 就是路径的大门，只有大门打开了，外界才能走这一条路。

在学习 http 的时候，我们知道发送请求的方法有好几种，其中包括 GET、POST、PUT、DELETE…

如果想要让客户端使用指定的请求方法的话，可以使用 @GetMapping、@PostMapping、@PutMapping 等

而 @RequestMapping 则是包含所有的请求方法，即客户端使用哪个请求方法都可以，这个注解我们经常使用

@RequestMapping 即是一个类注解，也是一个方法注解，访问路径是类路径 + 方法路径

如果要访问下面类的 r1 方法的话，url 为 http://127.0.0.1:8080/RequestController/r1?a=aaa
在这里插入图片描述

在写路径的时候，我们一般把路径名称定义为对应的类名或者方法名，可以不加 /，如果不加 Spring 会默认加上，一般我们都会加上 /

传递普通参数

使用基本类型传参的时候，参数为必传参数（除 boolean 之外），否则会报 500 错误
类型不匹配的时候，会报 400 错误

@RequestMapping("/ResController")
@RestController
public class RequestController {@RequestMapping("r2")public String r2(String a, int b) {return "接收参数：" + a + b;}
}

举个例子：
如果不传递 b 参数（int 类型），就会报错
在这里插入图片描述

IDEA 上也会报错：
在这里插入图片描述

如果你传递的类型不匹配，会报 400 的错误
在这里插入图片描述

IDEA 会提示 String 类型的参数无法传递给 int 类型里。

正常传递参数：
在这里插入图片描述

传递多个普通参数

在传递多个参数，只要参数的名称写对即可，不需要考虑顺序，Spring 会根据对应的参数名区接收参数。

@RequestMapping("/ResController")
@RestController
public class RequestController {@RequestMapping("/r6")public String r6(String name, int gender, int age) {return "接收到的参数：" + "name:" + name + " gender:" + gender + " age:" + age;}
}

在这里插入图片描述

传递对象

如果参数比较多的时候，方法的声明就需要很多的形参，并且后续每增加一个新的参数，方法的参数列表也要进行增加，为了方便书写，我们会将这些参数封装成一个对象，Spring MVC 会自动实现对对象参数的赋值

例如我们要传递一个 UserInfo 对象：

public class UserInfo {String name;int gender;int age;public UserInfo() {}public UserInfo(String name, int gender, int age) {this.name = name;this.gender = gender;this.age = age;}public String getName() {return name;}public void setName(String name) {this.name = name;}public int getGender() {return gender;}public void setGender(int gender) {this.gender = gender;}public int getAge() {return age;}public void setAge(int age) {this.age = age;}@Overridepublic String toString() {return "UserInfo{" +"name='" + name + '\'' +", gender=" + gender +", age=" + age +'}';}
}

@RequestMapping("/ResController")
@RestController
public class RequestController {@RequestMapping("/r7")public String r7(UserInfo userInfo) {return userInfo.toString();}
}

在这里插入图片描述

如果参数没有写全的话：由于是对象的参数，这些参数有默认值，没有传递的参数，一律使用默认值，这是 JavaSE 的知识了。

在这里插入图片描述

传递数组

@RequestMapping("/ResController")
@RestController
public class RequestController {@RequestMapping("/r9")public String r9(int[] arr) {return Arrays.toString(arr);}
}

在 postman 我们可以一个一个元素去传递
在这里插入图片描述

也可以一起传递过去
在这里插入图片描述

@RequestParam（参数重命名）

当前端传递的参数和我们后端自己写的参数不符合的时候，我们可以使用 @RequestParam 这个注解来重命名参数，例如：我们方法定义的参数为 name，但是前端想用 a 来进行传递，我们可以将 name 重命名为 a

@RequestMapping("/ResController")
@RestController
public class RequestController {@RequestMapping("/r8")public String r8(@RequestParam(value = "a") String name) {return "接收参数：" + name;}
}

在这里插入图片描述

参数进行重命名之后，外界只能使用重命名后的参数名称来传递数值，不可以使用后端定义的参数名！！！
否则会报 400 的客户端错误
在这里插入图片描述

源码解析

在这里插入图片描述
@RequsetParam 作用在参数上（PARAMETER）

其中重命名设置既可以使用 value = “新参数名”，也可以使用 name = “新参数名”

required 是指这个参数是必传的还是非必传的，@RequestParam 默认是必传参数，如果要设置非必传参数需要单独设置 required = false

必传参数与非必传参数

如果有写参数是可以不用传递的话，我们可以设置为非必传参数，这样没有传递参数也不会发生报错，没有传递参数会默认赋值为默认值，所以基本类型的参数即使设置为非必传参数也没用，基本类型的参数一定的必传的参数，否则就会发生报错。

非必传参数设置为 required = false

@RequestMapping("/ResController")
@RestController
public class RequestController {@RequestMapping("/r11")public String r11(@RequestParam(value = "s", required = false) String str) {return str + " test";}@RequestMapping("/r12")public int r12(@RequestParam(value = "a", required = false) int aaaa) {return aaaa;}
}

设置为非必传参数，在没有传递参数的话，会设置为默认值。
在这里插入图片描述

基本类型的参数就算设置为非必传参数也没用，没有传递依旧报错
在这里插入图片描述

传递集合

在参数传递的形式上，集合参数的传递和上面数组参数传递是一样的。

但是需要使用 @RequestParam 注解来绑定参数关系
默认情况下，请求中参数名称相同的多个值是封装到数组里的，如果要封装到集合中，需要使用 @RequestParam 绑定参数关系

@RequestMapping("/ResController")
@RestController
public class RequestController {@RequestMapping("/r10")public String r10(@RequestParam List<Integer> list) {return list.toString();}
}

在这里插入图片描述

JSON

JSON 介绍

JSON 和 JS 没有关系，只是语法相似。

JSON 本质上就是一个字符串，通过文本来存储和描述数据

Spring MVC 有 JSON 转换工具，我们可以直接使用，以此来完成JSON 和 Java对象的互传，当然网络上也有很多 JSON 转换工具，我们都可以直接拿来使用。

JSON 语法：
使用键值对（key，value）保存数据
数据与数据之间使用，分割
对象使用 { } 表示
数组使用 [ ] 表示
数值可以为对象，也可以为数组，数组中可以包含多个对象。

举例：下面的格式化的 JSON 数据：

{"squadName": "Super hero squad","homeTown": "Metro City","formed": 2016,"secretBase": "Super tower","active": true,"members": [{"name": "Molecule Man","age": 29,"secretIdentity": "Dan Jukes","powers": ["Radiation resistance", "Turning tiny", "Radiationblast "]},{"name": "Madame Uppercut","age": 39,"secretIdentity": "Jane Wilson","powers": ["Million tonne punch", "Damage resistance", "Superhumanreflexes "]},{"name": "Eternal Flame","age": 1000000,"secretIdentity": "Unknown","powers": ["Immortality", "Heat Immunity", "Inferno","Teleportation", "Interdimensional travel"]}]
}

也可以进行压缩然后表示：

{"squadName":"Super hero squad","homeTown":"Metro City","formed":2016,"secretBase":"Super tower","active":true,"members":[{"name":"Molecule Man","age":29,"secretIdentity":"Dan Jukes","powers":["Radiation resistance","Turning tiny","Radiationblast "]},{"name":"Madame Uppercut","age":39,"secretIdentity":"Jane Wilson","powers":["Million tonne punch","Damage resistance","Superhumanreflexes "]},{"name":"Eternal Flame","age":1000000,"secretIdentity":"Unknown","powers":["Immortality","Heat Immunity","Inferno","Teleportation","Interdimensional travel"]}]}

JSON 传递（@RequestBody）

使用 @RequestBody 来绑定参数，RequestBody 是作用在请求正文的数据绑定，请求参数必须写在请求正文中.

我们将 UserInfo 这个对象使用 JSON 格式的数据进行传递

public class UserInfo {String name;int gender;int age;public UserInfo() {}public UserInfo(String name, int gender, int age) {this.name = name;this.gender = gender;this.age = age;}public String getName() {return name;}public void setName(String name) {this.name = name;}public int getGender() {return gender;}public void setGender(int gender) {this.gender = gender;}public int getAge() {return age;}public void setAge(int age) {this.age = age;}@Overridepublic String toString() {return "UserInfo{" +"name='" + name + '\'' +", gender=" + gender +", age=" + age +'}';}
}

@RequestMapping("/ResController")
@RestController
public class RequestController {@RequestMapping("/r13")public String r13(@RequestBody UserInfo userInfo) {return userInfo.toString();}
}

在 postman 中选择 raw ，选择 JSON ，然后填写你要传递的 JSON 数据
在这里插入图片描述

在传递对象的参数使用 JSON 时，如果缺少默写参数，会使用参数的默认值进行填充，和之前我们提到的是一样的。
在这里插入图片描述

从 URL 获取参数 @PathVariable

如果方法参数名和需要绑定的URL中的变量名称一致时，可以不进行重命名
如果方法参数名和需要绑定的URL中的变量名称不一致的时候，需要进行重命名

在这里插入图片描述

将你要从URL获取的参数使用 { } 包裹起来，需要重命名的参数直接在 @PathVariable 里面填写即可。

@RequestMapping("/ResController")
@RestController
public class RequestController {@RequestMapping("/r14/{id}/{name}")public String r14(@PathVariable Integer id, @PathVariable("name") String userName) {return "id = " + id + " name = " + userName;}
}

在这里插入图片描述

上传文件 @RequestPart

    @RequestMapping("/r15")public String getFile(@RequestPart("file1") MultipartFile file) throws IOException {System.out.println(file.getOriginalFilename());//文件上传file.transferTo(new File("D:\\图\\" + file.getOriginalFilename()));return "文件上传成功!";}

在这里插入图片描述

查看电脑对应的路径，发现文件成功接收并下载到对应的路径里。
在这里插入图片描述

@RestController

注解源码解析

@ResquestMapping

传递普通参数

传递多个普通参数

传递对象

传递数组

@RequestParam（参数重命名）

源码解析

必传参数与非必传参数

传递集合

JSON

JSON 介绍

JSON 传递 （@RequestBody）

从 URL 获取参数 @PathVariable

上传文件 @RequestPart

相关文章：

JSON 传递（@RequestBody）