【SpringMVC】SpringMVC的请求与响应

文章目录

0. Tomcat环境的配置
1. PostMan工具介绍
- 创建WorkSpace
- 建立新的请求
2. 请求映射路径
- 案例结构与代码
- - 案例结构
  - 案例代码
- 案例存在问题
- 解决方案
- - 方法
  - 方法升级版——配置请求路径前缀
  - 注解总结
3. Get请求与Post请求
- 案例结构与案例代码
- - 案例结构
  - 案例代码
- Get请求
- Post请求
- 接收中文时的乱码问题
- - Post请求，通过过滤器解决
  - Get请求，通过配置解决
4. 五种类型参数传递
- 第一种：具有不同名称的普通参数
- 第二种：实体类(POJO参数)
- 第三种：嵌套POJO参数
- 第四种：数组参数
- 第五种：集合参数
5. JSON数据
- 导入json相关坐标
- 开启SpringMVC将JSON数据转换成对象的功能
- PostMan中发JSON的位置
- 第一种：JSON数组
- 第二种：JSON对象（POJO）
- 第三种：JSON数组（POJO）
- 关于@RequestBody
- @RequestBody和@ResponseParam的区别
6. 日期型参数传递
- 参数传递方法
- 类型转换器
7. 响应
- 响应页面
- 响应数据
- - 页面数据
  - 文本数据
  - JSON数据
  - List数据：JSON集合对象
- @ResponseBody注解介绍

0. Tomcat环境的配置

这里重新推荐下载安装Tomcat进行配置的方法：
第一步：安装Tomcat，可以不用看里面安装JDK的部分，毕竟都学到SpringMVC了，JDK肯定也安装了：Tomcat安装和配置，超详细（附JDK安装及配置环境变量）
第二步：在IDEA里面配置Tomcat运行环境：SpringMVC——配置tomcat
第三步：修改一下下面两个位置，使得我们通过/就可以访问，否则如果这个链接后面带了一堆乱七八糟的东西，我们访问localhost/会报404的错误：
在这里插入图片描述
注意，启动端口设置成了80，localhost等价于localhost:80

1. PostMan工具介绍

在这里插入图片描述
PostMan的作用就是模仿浏览器发出一些请求，比如Get请求、Post请求，如果在Post请求我们还需要自己写一个表单去提交，ajax请求的时候还需要些json，通过PostMan就可以解决以下这些问题

创建WorkSpace

在这里插入图片描述
创建了WorkSpace后我们也可以随时切换不同的WorkSpace：

建立新的请求

在这里插入图片描述
输入请求地址，得到响应内容：

点击preview的话就可以看到网页预览的结果，比如我们请求一下百度：

其他的话就是点击右上角的save可以将请求保存到左侧，方便后续测试使用

2. 请求映射路径

案例结构与代码

案例结构

在这里插入图片描述

案例代码

config/SpringMvcConfig.java

package com.demo.config;import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;@Configuration
@ComponentScan("com.demo.controller")
public class SpringMvcConfig {
}

config/ServletContainerInitConfig.java

package com.demo.config;import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;public class ServletContainerInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {@Overrideprotected Class<?>[] getRootConfigClasses() {return new Class[0];}@Overrideprotected Class<?>[] getServletConfigClasses() {return new Class[]{SpringMvcConfig.class};}@Overrideprotected String[] getServletMappings() {return new String[]{"/"};}
}

controller/BookController.java

package com.demo.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;@Controller
public class BookController {@RequestMapping("/save")@ResponseBodypublic String save(){System.out.println("book save ...");return "{'module': 'book save'}";}
}

controller/UserController.java

package com.demo.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;@Controller
public class UserController {@RequestMapping("/save")@ResponseBodypublic String save(){System.out.println("User save...");return "{'module': 'springmvc'}";}@RequestMapping("/delete")@ResponseBodypublic String delete(){System.out.println("User delete...");return "{'module': 'springmvc'}";}
}

案例存在问题

运行项目，会发现报错：
在这里插入图片描述

因为在BookController和UserController下有相同的路径，就会导致报错
团队多人开发，每个人设置不同的请求路径，应该怎么解决？

解决方案

方法

各个Controller用不同的路径
在UserController.java中带上/user前缀：

package com.demo.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;@Controller
public class UserController {@RequestMapping("/user/save")@ResponseBodypublic String save(){System.out.println("User save...");return "{'module': 'user save'}";}@RequestMapping("/user/delete")@ResponseBodypublic String delete(){System.out.println("User delete...");return "{'module': 'user delete'}";}
}

在BookController.java中带上/book前缀：

package com.demo.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;@Controller
public class BookController {@RequestMapping("/book/save")@ResponseBodypublic String save(){System.out.println("book save ...");return "{'module': 'book save'}";}
}

再次启动，问题解决，测试一下/user/save和/book/save：
在这里插入图片描述

方法升级版——配置请求路径前缀

在Controller上定义请求模块的前缀，在每一个Controller上加上对应的前缀，如下
在UserController.java模块顶部加上/user前缀：

package com.demo.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;@Controller
@RequestMapping("/user")
public class UserController {@RequestMapping("/save")@ResponseBodypublic String save(){System.out.println("User save...");return "{'module': 'user save'}";}@RequestMapping("/delete")@ResponseBodypublic String delete(){System.out.println("User delete...");return "{'module': 'user delete'}";}
}

在BookController.java模块顶部加上/book前缀：

package com.demo.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;@Controller
@RequestMapping("/book")
public class BookController {@RequestMapping("/save")@ResponseBodypublic String save(){System.out.println("book save ...");return "{'module': 'book save'}";}
}

重新启动并测试，发现仍然可用：
在这里插入图片描述

注解总结

注解：@RequestMapping
类型：方法注解、类注解
位置：Spring控制器方法定义上方
作用：设置当前控制器方法请求访问路径，如果设置在类上统一设置当前控制器方法请求访问路径前缀

3. Get请求与Post请求

两种请求的传参方式是不一样的，在这里理解在Get请求和Post请求中如何传参

案例结构与案例代码

案例结构

在这里插入图片描述

案例代码

config/ServletContainerInitConfig.java

package com.demo.config;import org.apache.ibatis.jdbc.Null;
import org.springframework.web.context.WebApplicationContext;
import org.springframework.web.context.support.AnnotationConfigWebApplicationContext;
import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;
import org.springframework.web.servlet.support.AbstractDispatcherServletInitializer;public class ServletContainerInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {@Overrideprotected Class<?>[] getRootConfigClasses() {return new Class[0];}@Overrideprotected Class<?>[] getServletConfigClasses() {return new Class[]{SpringMvcConfig.class};}@Overrideprotected String[] getServletMappings() {return new String[]{"/"};}
}

config/SpringMvcConfig.java

package com.demo.config;import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;@Configuration
@ComponentScan("com.demo.controller")
public class SpringMvcConfig {
}

controller/UserController.java

package com.demo.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;@Controller
public class UserController {@RequestMapping("/commonParam")@ResponseBodypublic String commonParam(){return "{'module': 'common param'}";}
}

domain/User.java：

package com.demo.domain;public class User {private String name;private int age;@Overridepublic String toString() {return "User{" +"name='" + name + '\'' +", age=" + age +'}';}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;}
}

domain/Address.java：

package com.demo.domain;public class Address {private String province;private String city;@Overridepublic String toString() {return "Address{" +"province='" + province + '\'' +", city='" + city + '\'' +'}';}public String getProvince() {return province;}public void setProvince(String province) {this.province = province;}public String getCity() {return city;}public void setCity(String city) {this.city = city;}
}

启动一下，看看是否能够跑通：
在这里插入图片描述

Get请求

一般Get请求是通过在链接后面接上?，然后再写具体的参数名称和内容，例如：localhost/commonParam?name=aaa
接收参数的方法就是在方法上加上对应的形参：

package com.demo.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;@Controller
public class UserController {@RequestMapping("/commonParam")@ResponseBodypublic String commonParam(String name){System.out.println("接收到的参数name==>" + name);return "{'module': 'common param'}";}
}

此时除了可以看到返回的结果，还可以在控制台看到打印的参数：
在这里插入图片描述
如果是多个参数，就修改上面代码的方法处，用多个参数进行接收即可：
public String commonParam(String name, int age)
再测试，结果如下：

PS: PostMan小技巧：如果不需要这个参数，就把前面的勾去掉，若彻底不再需要这个参数，在参数那一栏上的最右侧会有一个小垃圾桶，点击去除

Post请求

无论是Get请求还是Post请求，对于后台请求的代码来说没有变化，这里和Servlet不一样，Servlet中区分doGet和doPost，在这里合二为一了
在Postman中，我们如下测试，注意，在Post请求中不是在Param中写参数，而是在Body中写参数，Body下的x-www-form-urlencoded位置加上参数：
在这里插入图片描述

接收中文时的乱码问题

Post请求，通过过滤器解决

假如我们在Post请求中给name参数的是中文，在运行时候会发现接收到的参数乱码：
为了解决这个问题，我们就需要在ServletContainerInitConfig中设置一个过滤器：

package com.demo.config;import org.springframework.web.filter.CharacterEncodingFilter;
import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;import javax.servlet.Filter;public class ServletContainerInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {@Overrideprotected Class<?>[] getRootConfigClasses() {return new Class[0];}@Overrideprotected Class<?>[] getServletConfigClasses() {return new Class[]{SpringMvcConfig.class};}@Overrideprotected String[] getServletMappings() {return new String[]{"/"};}@Overrideprotected Filter[] getServletFilters() {CharacterEncodingFilter filter = new CharacterEncodingFilter();filter.setEncoding("UTF-8");return new Filter[]{filter};}
}

此时就可以解决中文乱码的问题：
在这里插入图片描述

Get请求，通过配置解决

如果是Get请求，如上配置后出来的还会是乱码（看弹幕有人说Tomcat8及以上设置了过滤器后Get请求出来的会是中文而不是乱码，如果使用本篇文章第0点中的方式来配置Tomcat，确实不会出现乱码的问题）
但是之前我是使用在pom.xml中通过配置来进行启动服务的配置，那时候我是参考了这一篇博客来设置GET请求不乱码：SpringMVC 中如何解决POST和GET请求中文乱码问题？（面试题）
修改pom.xml中的build配置如下，加上了uriEncoding的配置：

<build><plugins><plugin><groupId>org.apache.tomcat.maven</groupId><artifactId>tomcat7-maven-plugin</artifactId><version>2.1</version><configuration><port>80</port><path>/</path><uriEncoding>UTF-8</uriEncoding></configuration></plugin></plugins>
</build>

再次执行GET请求，结果如下：
在这里插入图片描述
注意：只设置下面这种而不写过滤器，是不能保证Post请求不乱码的
大概查了一下网上的资料，我认为一个请求不能满足两种需求的原因是：因为Post请求会把数据放到正文中传递，然后过滤器是针对于这个正文来设定的，然后我们配置的build是针对于得到的链接来进行设定的

4. 五种类型参数传递

第一种：具有不同名称的普通参数

在controller/UserController.java中加上一个方法：

@RequestMapping("/commonParamDifferentName")
@ResponseBody
public String commonParamDifferentName(String username, int age){System.out.println("接收到的参数name==>" + username);System.out.println("接收到的参数age==>" + age);return "{'module': 'common param different name'}";
}

使用不同名称的参数，则username就无法接收到：
在这里插入图片描述
如果想要使方法能够接收不同名称的参数，就使用注解：@RequestParam，如下：

@RequestMapping("/commonParamDifferentName")
@ResponseBody
public String commonParamDifferentName(@RequestParam("name") String username, int age){System.out.println("接收到的参数name==>" + username);System.out.println("接收到的参数age==>" + age);return "{'module': 'common param different name'}";
}

再进行测试，结果如下：
在这里插入图片描述

第二种：实体类(POJO参数)

在controller/UserController.java中加上一个方法：

@RequestMapping("/pojoParam")
@ResponseBody
public String pojoParam(User user){System.out.println("接收带的参数user==>" + user);return "{'module': 'pojo param'}";
}

在测试的时候带上name和age属性，框架可以帮我们自动封装到实体类中：
在这里插入图片描述

第三种：嵌套POJO参数

在controller/UserController.java中加上一个方法：

@RequestMapping("/pojoContainPojoParam")
@ResponseBody
public String pojoContainPojoParam(User user){System.out.println("pojo嵌套pojo参数传递 user ==> " + user);return "{'module': 'pojo contain pojo param'}";
}

在domain/User.java中加上一个Address属性，加上getter和setter方法，更新toString()方法：

package com.demo.domain;public class User {private String name;private int age;Address address;@Overridepublic String toString() {return "User{" +"name='" + name + '\'' +", age=" + age +", address=" + address +'}';}public Address getAddress() {return address;}public void setAddress(Address address) {this.address = address;}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;}
}

传参的时候，只需要通过属性名.属性来加上就可以了：
在这里插入图片描述

第四种：数组参数

在controller/UserController.java中加上一个方法：

@RequestMapping("/arrayParam")
@ResponseBody
public String stringParam(String[] likes){System.out.println("数组参数传递 likes ==> " + Arrays.toString(likes));return "{'module': 'array param'}";
}

数组只需要使用同一个参数接收就可以了，如下：
在这里插入图片描述

第五种：集合参数

在controller/UserController.java中加上一个方法：

@RequestMapping("/listParam")
@ResponseBody
public String listParam(List<String> likes){System.out.println("集合参数传递 likes ==> " + likes);return "{'module': 'list param'}";
}

如果使用像第四种那样的方式来进行传参，会报错java.lang.NoSuchMethodException: java.util.List.<init>()，显示没有这样的init方法
这是因为List<String>被当成pojo参数处理了。因为List<String>被视作了一个引用类型对象，而框架对于引用类型对象的处理是：先通过构造方法构造一个对象，然后通过set方法将属性set到这个对象里面去，所以这里会报错。
为了避免这个问题，我们需要修改这个方法中的参数，简单地加一下@RequestParam，让框架将其作为一个参数进行处理，而不是作为一个引用对象：

public String listParam(@RequestParam List<String> likes)

再运行，得到结果如下：
在这里插入图片描述

5. JSON数据

导入json相关坐标

<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.14.2</version>
</dependency>

开启SpringMVC将JSON数据转换成对象的功能

在controller/SpringMvcConfig.java中加上一个注解@EnableWebMvc
当然，这个注解能够实现的不止这个功能，该注解整合了多个功能，不止解析JSON这一个功能

package com.demo.config;import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;@Configuration
@ComponentScan("com.demo.controller")
@EnableWebMvc
public class SpringMvcConfig {
}

PostMan中发JSON的位置

在这里插入图片描述

第一种：JSON数组

在controller/UserController.java中加上一个方法：

@RequestMapping("/listParamForJson")
@ResponseBody
public String listParamForJson(List<String> likes){System.out.println("list common(json)参数传递 list ==> " + likes);return "{'module': list common for json param}";
}

对于被封装起来的JSON，我们在这里换一个注解：@RequestBody即可：public String listParamForJson(@RequestBody List<String> likes)，测试如下：
在这里插入图片描述

第二种：JSON对象（POJO）

在controller/UserController.java中加上一个方法，同理，为了解析JSON，需要加上@RequestBody：

@RequestMapping("/pojoParamForJson")
@ResponseBody
public String pojoParamForJson(@RequestBody User user){System.out.println("pojo(json)参数传递 user ==> " + user);return "{'module': pojo for json param}";
}

结果如下：
在这里插入图片描述
因为没有给address的信息，所以address=null，进一步改进一下：

第三种：JSON数组（POJO）

在controller/UserController.java中加上一个方法，类似的：

@RequestMapping("/listPojoParamForJson")
@ResponseBody
public String listPojoParamForJson(@RequestBody List<User> list){System.out.println("list pojo(json)参数传递 user ==> " + list);return "{'module': list pojo for json param}";
}

在这里插入图片描述

关于@RequestBody

类型：这个参数是一个形参注解
位置：定义位置在SpringMVC控制器方法形参定义前面
作用：将请求中请求体所包含的数据传递给请求参数，此注解一个处理器方法只能使用一次

@RequestBody和@ResponseParam的区别

区别
@RequestParam用于接收url地址传参，表单传参【application/x-www-form-urlencoded】
@RequestBody用于接收json数据【application/json】
应用
后期开发中，发送json格式数据为主，@RequestBody应用较广
如果发送非json格式数据，选用@RequestParam接收请求参数

6. 日期型参数传递

参数传递方法

在controller/UserController.java中加上一个方法：

@RequestMapping("/dataParam")
@ResponseBody
public String dataParam(Date date){System.out.println("参数传递 date ==> " + date);return "{'module': data param}";
}

测试一下，使用2088/08/08这种斜杠式是可以被解析的
在这里插入图片描述
在参数里面加上date1，打开上图的date1数据再测试，会报错无法解析这种格式：

这里应该使用注解@DateTimeFormat注解来指定格式：

@RequestMapping("/dataParam")
@ResponseBody
public String dataParam(Date date, @DateTimeFormat(pattern = "yyyy-MM-dd") Date date1){System.out.println("参数传递 date ==> " + date);System.out.println("参数传递 date1 ==> " + date1);return "{'module': data param}";
}

测试如下：
在这里插入图片描述

如果需要加上时间，就使用格式：@DateTimeFormat(pattern="yyyy/MM/dd HH:mm:ss)"即可：
在这里插入图片描述

类型转换器

Converter接口（其实我没找到这个）

public interface Converter<S, T>{@NullableT convert(S var1);
}

请求参数年龄数据（String→Integer）
日期格式转换（String→Date）

7. 响应

响应页面

在controller/UserController.java中加上一个方法：

@RequestMapping("/toJumpPage")
public String toJumpPage(){System.out.println("跳转页面");return "index.jsp";
}

则会自动跳转到如下的页面：
在这里插入图片描述

响应数据

页面数据

在controller/UserController.java中加上一个方法：

@RequestMapping(path="/toJumpPage")
public String toJumpPage(){System.out.println("跳转页面");return "index.jsp";
}

webapp/index.jsp中的内容：

<html>
<body>
<h2>Hello Spring MVC!</h2>
</body>
</html>

在浏览器中输入localhost/toJumpPage
得到以下结果：
在这里插入图片描述
这说明Controller中写方法，会自动帮我们找返回的这个String所对应的页面。

文本数据

在controller/UserController.java中加上一个方法，如果不用@ResponseBody，则方法会尝试去找一个叫做/response text的页面：

@RequestMapping("/toText")
@ResponseBody
public String toText(){System.out.println("返回纯文本数据");return "response text";
}

在这里插入图片描述

JSON数据

默认返回的是一个String，我们想让框架帮我们把User转换成JSON传递过去，其实就是需要修改响应的内容，响应的不再是页面，而需要我们自定义，则需要加上@ResponseBody注解

@RequestMapping("/toJsonPOJO")
@ResponseBody
public User toJsonPOJO(){System.out.println("返回json对象数据");User user = new User();user.setName("啊啊啊");user.setAge(15);return user;
}

在这里插入图片描述

List数据：JSON集合对象

@RequestMapping("/toJsonPOJOList")
@ResponseBody
public List<User> toJsonList(){System.out.println("返回JSON集合数据");User user1 = new User();user1.setName("aaa");user1.setAge(33);User user2 = new User();user2.setName("bbb");user2.setAge(22);List<User> userList = new ArrayList<>();userList.add(user1);userList.add(user2);return userList;
}