Spring（1）——mvc概念，部分常用注解
1、什么是Spring Web MVC？
Spring MVC 是一种基于 Java 的实现了 MVC（Model-View-Controller，模型 - 视图 - 控制器）设计模式的 Web 应用框架，它是 Spring 框架的一个重要组成部分，用于构建 Web 应用程序。
1.1 MVC定义
MVC是Model，View，Controller的缩写，它是软件⼯程中的⼀种软件架构设计模式，它把软件系统分为模型、视图和控制器三个基本部分。
**View（视图）：**指在应⽤程序中专⻔⽤来与浏览器进⾏交互，展⽰数据的资源.
**Model（模型）：**是应⽤程序的主体部分，⽤来处理程序中数据逻辑的部分.
**Controller（控制器）：**可以理解为⼀个分发器，⽤来决定对于视图发来的请求，需要⽤哪⼀个模型来处理，以及处理完后需要跳回到哪⼀个视图。即⽤来连接视图和模型 。
1.2 什么是Spring MVC？
Sping MVC是对MVC架构的实现，是一个Web框架，不过Sping MVC中MVC的架构稍有改变
浏览器发来的请求将直接通过控制器简单处理后，传给对应的模型而不经过视图。
对于Spring MVC，当用户在浏览器中输入了URL之后是如何感知到用户的请求并给予相应的？
主要分以下三个方面：
-
建⽴连接：将用户（浏览器）和Java程序连接起来，也就是访问⼀个地址能够调⽤到我们的Spring程序。
-
请求:⽤⼾请求的时候会带⼀些参数，在程序中要想办法获取到参数,所以请求这块主要是获取参数
的功能。 -
响应:执⾏了业务逻辑之后，要把程序执⾏的结果返回给⽤⼾,也就是响应. 。
1.2.1 传递参数
下面四种分别体现了get和post的两种实现方式
@RestController
@RequestMapping("/user")
public class UserController {
@RequestMapping(value = "/v1",method = RequestMethod.GET)
public String v1() {
return "Hello method = RequestMethod.GET";
}
@GetMapping("/v2")
public String v2() {
return "Hello GetMapping";
}
@RequestMapping(value = "/v3", method = RequestMethod.POST)
public String v3() {
return "Hello method = RequestMethod.POST";
}
@PostMapping("/v4")
public String v4() {
return "Hello PostMapping";
}
}
1.2.2 传递对象
- 如果参数⽐较多时,⽅法声明就需要有很多形参.并且后续每次新增⼀个参数,也需要修改⽅法声明.
- 我们不妨把这些参数封装为⼀个对象.
- SpringMVC也可以⾃动实现对象参数的赋值，⽐如Person对象：
- 需要注意的是对象类必须完成get和set方法Spring才能赋值和取值
public class Person {
private int id;
private String name;
private String password;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
@Override
public String toString() {
return "Person{" +
"id=" + id +
", name='" + name + '\'' +
", password='" + password + '\'' +
'}';
}
}
传递对象代码实现：
@RequestMapping("/m3")
public Object method3(Person p){
return p.toString();
}
1.2.3 给参数重命名
前后端对同一个参数名称命名习惯可能不同，比如对于用户名，前端有可能是userName,后端是name。这种情况就需要给参数重命名。
创建前端请求：
后端使用**@RequestParam**注解：
前端得到的相应：
如果此时前端名称改为name，即和后端参数列表中同一参数名一样是不能传递成功的：
就是说后端只认重命名注解中的名字。
还有一点需要注意的是，当对一个参数使用了**@RequestParam**注解时，这个参数就默认成为了必传参数，即前端如果没有传递该参数，会产生请求错误：
可以得出结论:
-
使⽤**@RequestParam** 进⾏参数重命名时,请求参数只能和**@RequestParam** 声明的名称⼀
致,才能进⾏参数绑定和赋值. -
使⽤ @RequestParam 进⾏参数重命名时,参数就变成了必传参数.
如果我们的实际业务前端的参数是⼀个⾮必传的参数,针对上述问题,如何解决呢?
先来了解下参数必传的原因,我们查看 @RequestParam 注解的实现细节就可以发现端倪，注解实现如下：
@Target({ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface RequestParam {
@AliasFor("name")
String value() default "";
@AliasFor("value")
String name() default "";
boolean required() default true;
String defaultValue() default "\n\t\t\n\t\t\n\ue000\ue001\ue002\n\t\t\t\t\n";
}
可以看到 required 的默认值为true,表⽰含义就是:该注解修饰的参数默认为必传。既然如此,我们可以通过设置 @RequestParam 中的 required=false 来避免不传递时报错，
具体实现如下 ：
@RequestMapping("/v3")
public String v3(@RequestParam(value = "userName",required = false) String name, Integer age){
return name + " " + age;
}
此时被**@RequestParam**注解的参数就不是必传参数了
1.2.4 传递数组
代码如下：
@RequestMapping("/v4")
public String v4(String[] array){
System.out.println(array.length);
return Arrays.toString(array);
}
前端可以这样传
-
后端也可以看到数组长度为4
-
同一个参数传多次，也会被认为同一个数组，后端也可以看到数组长度为3
1.2.5 传递List
@RequestMapping("/v5")
public String v5(@RequestParam List<String> list){
System.out.println(list.size());
return Arrays.toString(list.toArray());
}
需要用**@RequestParam**对参数进行标记
1.3 传递JSON数据
1.3.1 JSON的语法:
- 数据在键值对(Key/Value) 中
- 数据由逗号**,**分隔
- 对象⽤ {} 表示
- 数组⽤** []** 表示
- 值可以为对象,也可以为数组,数组中可以包含多个对象
1.3.2 JSON的两种结构
- 对象:⼤括号 {} 保存的对象是⼀个⽆序的键值对集合。⼀个对象以左括号 { 开始，右括号 }
结束。每个"键"后跟⼀个冒号 : ，键值对使⽤逗号 , 分隔 - 数组:中括号 [] 保存的数组是值（value）的有序集合.⼀个数组以左中括号 [ 开始，右中括
号 ] 结束，值之间使⽤逗号 , 分隔。
如下：
1.3.3 Json字符串和Java对象的转换
JSON本质上是⼀个字符串,通过⽂本来存储和描述数据。
SpringMVC框架也集成了JSON的转换⼯具,我们可以直接使⽤,来完成JSON字符串和Java对象的互转。
//对象
public class User {
String name;
int age;
String gender;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String getGender() {
return gender;
}
public void setGender(String gender) {
this.gender = gender;
}
@Override
public String toString() {
return "User{" +
"name='" + name + '\'' +
", age=" + age +
", gender='" + gender + '\'' +
'}';
}
}
使⽤ObjectMapper对象提供的两个⽅法,可以完成对象和JSON字符串的互转
writeValueAsString:把对象转为JSON字符串
readValue:把字符串转为对象
public class JsonTest {
public static void main(String[] args) throws JsonProcessingException {
ObjectMapper objectMapper = new ObjectMapper();
User user = new User();
user.age = 17;
user.name = "火车";
//对象转json
String s = objectMapper.writeValueAsString(user);
System.out.println("json字符串:" + s);
//json转对象
User user1 = objectMapper.readValue(s, user.getClass());
System.out.println(user1);
}
}
运行结果：
Json字符串和Java对象的转换本质上是jackson-databind提供的功能,SpringMVC框架中已经把该⼯具包引⼊了进来,咱们直接使⽤即可,如果脱离SpringMVC使⽤,需要引⼊相关依赖
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.13.5</version>
</dependency>
1.3.4 传递Json对象
接受JSON对象，需要使用**@RequsetBody**注解。
@RequestMapping("/v6")
public String v6(@RequestBody User user){
return user.toString();
}
1.4 获取URL中的参数
使用**@PathVariable**注解
@RequestMapping("/user/{id}/{name}")
public String getArticle(@PathVariable("id") String id,@PathVariable("name") String name){
return "id:" + id + "\n" + "name:" +name;
}
1.5上传文件
@RequestMapping("/v7")
public String getFile(@RequestPart("file")MultipartFile file) throws IOException {
String originalFilename = file.getOriginalFilename();
file.transferTo(new File("f:\\重头来过\\" + file.getOriginalFilename()));
return "接收到文件名称为： " + originalFilename;
}
可以看到上传成功
二、总结
- @RequestMapping:路由映射
- @RequestParam:后端参数重命名
- @RequestBody:接收JSON类型的参数
- @PathVariable:接收路径参数
- @RequestPart:上传⽂件