SpringMVC的请求与响应（请求映射路径、请求参数、日期类型参数传递、响应json数据）

迈不过友情╰ 2024-03-22 18:59 16阅读 0赞

#### 文章目录 ####

*   *  1，PostMan工具的使用
     *   *  1.1 PostMan简介
         *  1.2 PostMan安装
         *  1.3 PostMan使用
         *   *  1.3.1 创建WorkSpace工作空间
             *  1.3.2 发送请求
             *  1.3.3 保存当前请求
     *  2，请求与响应
     *   *  2.1 设置请求映射路径
         *   *  2.1.1 环境准备
             *  2.1.2 问题分析
             *  2.1.3 设置映射路径
             *   *  步骤1:修改Controller
                 *  步骤2:优化路径配置
         *  2.2 请求参数
         *   *  2.2.1 环境准备
             *  2.2.2 参数传递
             *   *  GET发送单个参数
                 *  GET发送多个参数
                 *  GET请求中文乱码
                 *  POST发送参数
                 *  POST请求中文乱码
         *  2.3 五种类型参数传递
         *   *  2.3.1 普通参数
             *  2.3.2 POJO数据类型
             *  2.3.3 嵌套POJO类型参数
             *  2.3.4 数组类型参数
             *  2.3.5 集合类型参数
         *  知识点1：@RequestParam
         *  2.4 JSON数据传输参数
         *   *  JSON普通数组
             *   *   *  步骤1:pom.xml添加依赖
                     *  步骤2:PostMan发送JSON数据
                     *  步骤3:开启SpringMVC注解支持
                     *  步骤4:参数前添加@RequestBody
                     *  步骤5:启动运行程序
             *  JSON对象数据
             *  JSON对象数组
             *  知识点1：@EnableWebMvc
             *  知识点2：@RequestBody
             *  @RequestBody与@RequestParam区别
         *  2.5 日期类型参数传递
         *   *  步骤1:编写方法接收日期数据
             *  步骤2:启动Tomcat服务器
             *  步骤3:使用PostMan发送请求
             *  步骤4:查看控制台
             *  步骤5:更换日期格式
             *  步骤6:携带时间的日期
             *  知识点1：@DateTimeFormat
             *  内部实现原理
         *  2.6 响应
         *   *  2.6.1 环境准备
             *  2.6.2 响应页面\[了解\]
             *   *  步骤1:设置返回页面
                 *  步骤2:启动程序测试
             *  2.6.3 返回文本数据\[了解\]
             *   *  步骤1:设置返回文本内容
                 *  步骤2:启动程序测试
             *  2.6.4 响应JSON数据
             *   *  响应POJO对象
                 *  响应POJO集合对象
             *  知识点1：@ResponseBody

### 1，PostMan工具的使用 ###

#### 1.1 PostMan简介 ####

代码编写完后，我们要想测试，只需要打开浏览器直接输入地址发送请求即可。发送的是`GET`请求可以直接使用浏览器，但是如果要发送的是`POST`请求呢?

如果要求发送的是post请求，我们就得准备页面在页面上准备form表单，测试起来比较麻烦。所以我们就需要借助一些第三方工具，如PostMan.

*  PostMan是一款功能强大的网页调试与发送网页HTTP请求的Chrome插件。![1630463382386][]
 *  作用：常用于进行接口测试
 *  特征
    
     *  简单
     *  实用
     *  美观
     *  大方

#### 1.2 PostMan安装 ####

双击`资料\Postman-win64-8.3.1-Setup.exe`即可自动安装，

安装完成后，如果需要注册，可以按照提示进行注册，如果底部有跳过测试的链接也可以点击跳过注册

![1630463816424][]

看到如下界面，就说明已经安装成功。

![1630463887711][]

#### 1.3 PostMan使用 ####

##### 1.3.1 创建WorkSpace工作空间 #####

![19a039a1c56f34c34f85bb3da30b2265.png][]

##### 1.3.2 发送请求 #####

![1630464489898][]

##### 1.3.3 保存当前请求 #####

![1630464783034][]

**注意** 第一次请求需要创建一个新的目录，后面就不需要创建新目录，直接保存到已经创建好的目录即可。

### 2，请求与响应 ###

前面我们已经完成了入门案例相关的知识学习，接来了我们就需要针对SpringMVC相关的知识点进行系统的学习，之前我们提到过，SpringMVC是web层的框架，主要的作用是接收请求、接收数据、响应结果，所以这一章节是学习SpringMVC的重点内容，我们主要会讲解四部分内容:

*  请求映射路径
 *  请求参数
 *  日期类型参数传递
 *  响应json数据

#### 2.1 设置请求映射路径 ####

##### 2.1.1 环境准备 #####

*  创建一个Web的Maven项目
 *  pom.xml添加Spring依赖
    
        <?xml version="1.0" encoding="UTF-8"?>
        
        <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
          <modelVersion>4.0.0</modelVersion>
        
          <groupId>com.itheima</groupId>
          <artifactId>springmvc_03_request_mapping</artifactId>
          <version>1.0-SNAPSHOT</version>
          <packaging>war</packaging>
        
          <dependencies>
            <dependency>
              <groupId>javax.servlet</groupId>
              <artifactId>javax.servlet-api</artifactId>
              <version>3.1.0</version>
              <scope>provided</scope>
            </dependency>
            <dependency>
              <groupId>org.springframework</groupId>
              <artifactId>spring-webmvc</artifactId>
              <version>5.2.10.RELEASE</version>
            </dependency>
          </dependencies>
        
          <build>
            <plugins>
              <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.1</version>
                <configuration>
                  <port>80</port>
                  <path>/</path>
                </configuration>
              </plugin>
            </plugins>
          </build>
        </project>
 *  创建对应的配置类
    
        public class ServletContainersInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
              
        
            protected Class<?>[] getServletConfigClasses() {
              
                return new Class[]{
              SpringMvcConfig.class};
            }
            protected String[] getServletMappings() {
              
                return new String[]{
              "/"};
            }
            protected Class<?>[] getRootConfigClasses() {
              
                return new Class[0];
            }
        }
        
        @Configuration
        @ComponentScan("com.itheima.controller")
        public class SpringMvcConfig {
              
        }
 *  编写BookController和UserController
    
        @Controller
        public class UserController {
              
        
            @RequestMapping("/save")
            @ResponseBody
            public String save(){
              
                System.out.println("user save ...");
                return "{'module':'user save'}";
            }
            
            @RequestMapping("/delete")
            @ResponseBody
            public String save(){
              
                System.out.println("user delete ...");
                return "{'module':'user delete'}";
            }
        }
        
        @Controller
        public class BookController {
              
        
            @RequestMapping("/save")
            @ResponseBody
            public String save(){
              
                System.out.println("book save ...");
                return "{'module':'book save'}";
            }
        }

最终创建好的项目结构如下:

![1630466431549][]

把环境准备好后，启动Tomcat服务器，后台会报错:

![1630466555934][]

从错误信息可以看出:

*  UserController有一个save方法，访问路径为`http://localhost/save`
 *  BookController也有一个save方法，访问路径为`http://localhost/save`
 *  当访问`http://localhost/saved`的时候，到底是访问UserController还是BookController?

##### 2.1.2 问题分析 #####

团队多人开发，每人设置不同的请求路径，冲突问题该如何解决?

解决思路:为不同模块设置模块名作为请求路径前置

对于Book模块的save,将其访问路径设置`http://localhost/book/save`

对于User模块的save,将其访问路径设置`http://localhost/user/save`

这样在同一个模块中出现命名冲突的情况就比较少了。

##### 2.1.3 设置映射路径 #####

###### 步骤1:修改Controller ######

@Controller
    public class UserController {
        
    
        @RequestMapping("/user/save")
        @ResponseBody
        public String save(){
        
            System.out.println("user save ...");
            return "{'module':'user save'}";
        }
        
        @RequestMapping("/user/delete")
        @ResponseBody
        public String save(){
        
            System.out.println("user delete ...");
            return "{'module':'user delete'}";
        }
    }
    
    @Controller
    public class BookController {
        
    
        @RequestMapping("/book/save")
        @ResponseBody
        public String save(){
        
            System.out.println("book save ...");
            return "{'module':'book save'}";
        }
    }

问题是解决了，但是每个方法前面都需要进行修改，写起来比较麻烦而且还有很多重复代码，如果/user后期发生变化，所有的方法都需要改，耦合度太高。

###### 步骤2:优化路径配置 ######

优化方案:

@Controller
    @RequestMapping("/user")
    public class UserController {
        
    
        @RequestMapping("/save")
        @ResponseBody
        public String save(){
        
            System.out.println("user save ...");
            return "{'module':'user save'}";
        }
        
        @RequestMapping("/delete")
        @ResponseBody
        public String save(){
        
            System.out.println("user delete ...");
            return "{'module':'user delete'}";
        }
    }
    
    @Controller
    @RequestMapping("/book")
    public class BookController {
        
    
        @RequestMapping("/save")
        @ResponseBody
        public String save(){
        
            System.out.println("book save ...");
            return "{'module':'book save'}";
        }
    }

**注意:**

*  当类上和方法上都添加了`@RequestMapping`注解，前端发送请求的时候，要和两个注解的value值相加匹配才能访问到。
 *  @RequestMapping注解value属性前面加不加`/`都可以

扩展小知识:

对于PostMan如何觉得字小不好看，可以使用`ctrl+=`调大，`ctrl+-`调小。

#### 2.2 请求参数 ####

请求路径设置好后，只要确保页面发送请求地址和后台Controller类中配置的路径一致，就可以接收到前端的请求，接收到请求后，如何接收页面传递的参数?

关于请求参数的传递与接收是和请求方式有关系的，目前比较常见的两种请求方式为：

*  GET
 *  POST

针对于不同的请求前端如何发送，后端如何接收?

##### 2.2.1 环境准备 #####

*  创建一个Web的Maven项目
 *  pom.xml添加Spring依赖
    
        <?xml version="1.0" encoding="UTF-8"?>
        
        <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
          <modelVersion>4.0.0</modelVersion>
        
          <groupId>com.itheima</groupId>
          <artifactId>springmvc_03_request_mapping</artifactId>
          <version>1.0-SNAPSHOT</version>
          <packaging>war</packaging>
        
          <dependencies>
            <dependency>
              <groupId>javax.servlet</groupId>
              <artifactId>javax.servlet-api</artifactId>
              <version>3.1.0</version>
              <scope>provided</scope>
            </dependency>
            <dependency>
              <groupId>org.springframework</groupId>
              <artifactId>spring-webmvc</artifactId>
              <version>5.2.10.RELEASE</version>
            </dependency>
          </dependencies>
        
          <build>
            <plugins>
              <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.1</version>
                <configuration>
                  <port>80</port>
                  <path>/</path>
                </configuration>
              </plugin>
            </plugins>
          </build>
        </project>
 *  创建对应的配置类
    
        public class ServletContainersInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
              
        
            protected Class<?>[] getServletConfigClasses() {
              
                return new Class[]{
              SpringMvcConfig.class};
            }
            protected String[] getServletMappings() {
              
                return new String[]{
              "/"};
            }
            protected Class<?>[] getRootConfigClasses() {
              
                return new Class[0];
            }
        }
        
        @Configuration
        @ComponentScan("com.itheima.controller")
        public class SpringMvcConfig {
              
        }
 *  编写UserController
    
        @Controller
        public class UserController {
              
        
            @RequestMapping("/commonParam")
            @ResponseBody
            public String commonParam(){
              
                return "{'module':'commonParam'}";
            }
        }

*  编写模型类，User和Address
    
        public class Address {
              
            private String province;
            private String city;
            //setter...getter...略
        }
        public class User {
              
            private String name;
            private int age;
            //setter...getter...略
        }

最终创建好的项目结构如下:

![1630467830654][]

##### 2.2.2 参数传递 #####

###### GET发送单个参数 ######

发送请求与参数:

http://localhost/commonParam?name=itcast

![1630467921300][]

接收参数：

@Controller
    public class UserController {
        
    
        @RequestMapping("/commonParam")
        @ResponseBody
        public String commonParam(String name){
        
            System.out.println("普通参数传递 name ==> "+name);
            return "{'module':'commonParam'}";
        }
    }

###### GET发送多个参数 ######

发送请求与参数:

http://localhost/commonParam?name=itcast&age=15

![1630468045733][]

接收参数：

@Controller
    public class UserController {
        
    
        @RequestMapping("/commonParam")
        @ResponseBody
        public String commonParam(String name,int age){
        
            System.out.println("普通参数传递 name ==> "+name);
            System.out.println("普通参数传递 age ==> "+age);
            return "{'module':'commonParam'}";
        }
    }

###### GET请求中文乱码 ######

如果我们传递的参数中有中文，你会发现接收到的参数会出现中文乱码问题。

发送请求:`http://localhost/commonParam?name=张三&age=18`

控制台:

![1630480536510][]

出现乱码的原因相信大家都清楚，Tomcat8.5以后的版本已经处理了中文乱码的问题，但是IDEA中的Tomcat插件目前只到Tomcat7，所以需要修改pom.xml来解决GET请求中文乱码问题

<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>

###### POST发送参数 ######

发送请求与参数:

![1630480812809][]接收参数：

和GET一致，不用做任何修改

###### POST请求中文乱码 ######

发送请求与参数:

![1630480964421][]

接收参数:

控制台打印，会发现有中文乱码问题。

![1630481008109][]

解决方案:配置过滤器

public class ServletContainersInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
        
        protected Class<?>[] getRootConfigClasses() {
        
            return new Class[0];
        }
    
        protected Class<?>[] getServletConfigClasses() {
        
            return new Class[]{
        SpringMvcConfig.class};
        }
    
        protected String[] getServletMappings() {
        
            return new String[]{
        "/"};
        }
    
        //乱码处理
        @Override
        protected Filter[] getServletFilters() {
        
            CharacterEncodingFilter filter = new CharacterEncodingFilter();
            filter.setEncoding("UTF-8");
            return new Filter[]{
        filter};
        }
    }

CharacterEncodingFilter是在spring-web包中，所以用之前需要导入对应的jar包。

#### 2.3 五种类型参数传递 ####

前面我们已经能够使用GET或POST来发送请求和数据，所携带的数据都是比较简单的数据，接下来在这个基础上，我们来研究一些比较复杂的参数传递，常见的参数种类有:

*  普通参数
 *  POJO类型参数
 *  嵌套POJO类型参数
 *  数组类型参数
 *  集合类型参数

这些参数如何发送，后台改如何接收?我们一个个来学习。

##### 2.3.1 普通参数 #####

*  普通参数:url地址传参，地址参数名与形参变量名相同，定义形参即可接收参数。

![1630481585729][]

如果形参与地址参数名不一致该如何解决?

发送请求与参数:

http://localhost/commonParamDifferentName?name=张三&age=18

后台接收参数:

@RequestMapping("/commonParamDifferentName")
    @ResponseBody
    public String commonParamDifferentName(String userName , int age){
        
        System.out.println("普通参数传递 userName ==> "+userName);
        System.out.println("普通参数传递 age ==> "+age);
        return "{'module':'common param different name'}";
    }

因为前端给的是`name`,后台接收使用的是`userName`,两个名称对不上，导致接收数据失败:

![1630481772035][]

解决方案:使用@RequestParam注解

@RequestMapping("/commonParamDifferentName")
        @ResponseBody
        public String commonParamDifferentName(@RequestPaam("name") String userName , int age){
        
            System.out.println("普通参数传递 userName ==> "+userName);
            System.out.println("普通参数传递 age ==> "+age);
            return "{'module':'common param different name'}";
        }

**注意:写上@RequestParam注解框架就不需要自己去解析注入，能提升框架处理性能**

##### 2.3.2 POJO数据类型 #####

简单数据类型一般处理的是参数个数比较少的请求，如果参数比较多，那么后台接收参数的时候就比较复杂，这个时候我们可以考虑使用POJO数据类型。

*  POJO参数：请求参数名与形参对象属性名相同，定义POJO类型形参即可接收参数

此时需要使用前面准备好的POJO类，先来看下User

public class User {
        
        private String name;
        private int age;
        //setter...getter...略
    }

发送请求和参数:

![1630482186745][]

后台接收参数:

//POJO参数：请求参数与形参对象中的属性对应即可完成参数传递
    @RequestMapping("/pojoParam")
    @ResponseBody
    public String pojoParam(User user){
        
        System.out.println("pojo参数传递 user ==> "+user);
        return "{'module':'pojo param'}";
    }

**注意:**

*  POJO参数接收，前端GET和POST发送请求数据的方式不变。
 *  请求参数key的名称要和POJO中属性的名称一致，否则无法封装。

##### 2.3.3 嵌套POJO类型参数 #####

如果POJO对象中嵌套了其他的POJO类，如

public class Address {
        
        private String province;
        private String city;
        //setter...getter...略
    }
    public class User {
        
        private String name;
        private int age;
        private Address address;
        //setter...getter...略
    }

*  嵌套POJO参数：请求参数名与形参对象属性名相同，按照对象层次结构关系即可接收嵌套POJO属性参数

发送请求和参数:

![1630482363291][]

后台接收参数:

**注意:**

请求参数key的名称要和POJO中属性的名称一致，否则无法封装

##### 2.3.4 数组类型参数 #####

举个简单的例子，如果前端需要获取用户的爱好，爱好绝大多数情况下都是多个，如何发送请求数据和接收数据呢?

*  数组参数：请求参数名与形参对象属性名相同且请求参数为多个，定义数组类型即可接收参数

发送请求和参数:

![1630482999626][]

后台接收参数:

//数组参数：同名请求参数可以直接映射到对应名称的形参数组对象中
        @RequestMapping("/arrayParam")
        @ResponseBody
        public String arrayParam(String[] likes){
        
            System.out.println("数组参数传递 likes ==> "+ Arrays.toString(likes));
            return "{'module':'array param'}";
        }

##### 2.3.5 集合类型参数 #####

数组能接收多个值，那么集合是否也可以实现这个功能呢?

发送请求和参数:

![1630484283773][]

后台接收参数:

//集合参数：同名请求参数可以使用@RequestParam注解映射到对应名称的集合对象中作为数据
    @RequestMapping("/listParam")
    @ResponseBody
    public String listParam(List<String> likes){
        
        System.out.println("集合参数传递 likes ==> "+ likes);
        return "{'module':'list param'}";
    }

运行会报错，

![1630484339065][]

错误的原因是:SpringMVC将List看做是一个POJO对象来处理，将其创建一个对象并准备把前端的数据封装到对象中，但是List是一个接口无法创建对象，所以报错。

解决方案是:使用`@RequestParam`注解

//集合参数：同名请求参数可以使用@RequestParam注解映射到对应名称的集合对象中作为数据
    @RequestMapping("/listParam")
    @ResponseBody
    public String listParam(@RequestParam List<String> likes){
        
        System.out.println("集合参数传递 likes ==> "+ likes);
        return "{'module':'list param'}";
    }

*  集合保存普通参数：请求参数名与形参集合对象名相同且请求参数为多个，@RequestParam绑定参数关系
 *  对于简单数据类型使用数组会比集合更简单些。

#### 知识点1：@RequestParam ####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>@RequestParam</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>类型</td> 
   <td>形参注解</td> 
  </tr> 
  <tr> 
   <td>位置</td> 
   <td>SpringMVC控制器方法形参定义前面</td> 
  </tr> 
  <tr> 
   <td>作用</td> 
   <td>绑定请求参数与处理器方法形参间的关系</td> 
  </tr> 
  <tr> 
   <td>相关参数</td> 
   <td>required：是否为必传参数 <br>defaultValue：参数默认值</td> 
  </tr> 
 </tbody> 
</table>

#### 2.4 JSON数据传输参数 ####

前面我们说过，现在比较流行的开发方式为异步调用。前后台以异步方式进行交换，传输的数据使用的是JSON,所以前端如果发送的是JSON数据，后端该如何接收?

对于JSON数据类型，我们常见的有三种:

*  json普通数组（\[“value1”,“value2”,“value3”,…\]）
 *  json对象（\{key1:value1,key2:value2,…\}）
 *  json对象数组（\[\{key1:value1,…\},\{key2:value2,…\}\]）

对于上述数据，前端如何发送，后端如何接收?

##### JSON普通数组 #####

###### 步骤1:pom.xml添加依赖 ######

SpringMVC默认使用的是jackson来处理json的转换，所以需要在pom.xml添加jackson依赖

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

###### 步骤2:PostMan发送JSON数据 ######

![1630485135061][]

###### 步骤3:开启SpringMVC注解支持 ######

在SpringMVC的配置类中开启SpringMVC的注解支持，这里面就包含了将JSON转换成对象的功能。

@Configuration
    @ComponentScan("com.itheima.controller")
    //开启json数据类型自动转换
    @EnableWebMvc
    public class SpringMvcConfig {
        
    }

###### 步骤4:参数前添加@RequestBody ######

//使用@RequestBody注解将外部传递的json数组数据映射到形参的集合对象中作为数据
    @RequestMapping("/listParamForJson")
    @ResponseBody
    public String listParamForJson(@RequestBody List<String> likes){
        
        System.out.println("list common(json)参数传递 list ==> "+likes);
        return "{'module':'list common for json param'}";
    }

###### 步骤5:启动运行程序 ######

![1630492624684][]

JSON普通数组的数据就已经传递完成，下面针对JSON对象数据和JSON对象数组的数据该如何传递呢?

##### JSON对象数据 #####

我们会发现，只需要关注请求和数据如何发送?后端数据如何接收?

请求和数据的发送:

{
        
    	"name":"itcast",
    	"age":15
    }

![1630493105450][]

后端接收数据：

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

启动程序访问测试

![1630493233550][]

**说明:**

address为null的原因是前端没有传递数据给后端。

如果想要address也有数据，我们需求修改前端传递的数据内容:

{
        
    	"name":"itcast",
    	"age":15,
        "address":{
        
            "province":"beijing",
            "city":"beijing"
        }
    }

再次发送请求，就能看到address中的数据

![1630493450694][]

##### JSON对象数组 #####

集合中保存多个POJO该如何实现?

请求和数据的发送:

[
        {
        "name":"itcast","age":15},
        {
        "name":"itheima","age":12}
    ]

![1630493501205][]

后端接收数据:

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

启动程序访问测试

![1630493561137][]

**小结**

SpringMVC接收JSON数据的实现步骤为:

(1)导入jackson包

(2)使用PostMan发送JSON数据

(3)开启SpringMVC注解驱动，在配置类上添加@EnableWebMvc注解

(4)Controller方法的参数前添加@RequestBody注解

##### 知识点1：@EnableWebMvc #####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>@EnableWebMvc</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>类型</td> 
   <td>配置类注解</td> 
  </tr> 
  <tr> 
   <td>位置</td> 
   <td>SpringMVC配置类定义上方</td> 
  </tr> 
  <tr> 
   <td>作用</td> 
   <td>开启SpringMVC多项辅助功能</td> 
  </tr> 
 </tbody> 
</table>

##### 知识点2：@RequestBody #####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>@RequestBody</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>类型</td> 
   <td>形参注解</td> 
  </tr> 
  <tr> 
   <td>位置</td> 
   <td>SpringMVC控制器方法形参定义前面</td> 
  </tr> 
  <tr> 
   <td>作用</td> 
   <td>将请求中请求体所包含的数据传递给请求参数，此注解一个处理器方法只能使用一次</td> 
  </tr> 
 </tbody> 
</table>

##### @RequestBody与@RequestParam区别 #####

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

#### 2.5 日期类型参数传递 ####

前面我们处理过简单数据类型、POJO数据类型、数组和集合数据类型以及JSON数据类型，接下来我们还得处理一种开发中比较常见的一种数据类型，`日期类型`

日期类型比较特殊，因为对于日期的格式有N多中输入方式，比如:

*  2088-08-18
 *  2088/08/18
 *  08/18/2088
 *  …

针对这么多日期格式，SpringMVC该如何接收，它能很好的处理日期类型数据么?

##### 步骤1:编写方法接收日期数据 #####

在UserController类中添加方法，把参数设置为日期类型

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

##### 步骤2:启动Tomcat服务器 #####

查看控制台是否报错，如果有错误，先解决错误。

##### 步骤3:使用PostMan发送请求 #####

使用PostMan发送GET请求，并设置date参数

`http://localhost/dataParam?date=2088/08/08`

![1630494320917][]

##### 步骤4:查看控制台 #####

![1630494443738][]

通过打印，我们发现SpringMVC可以接收日期数据类型，并将其打印在控制台。

这个时候，我们就想如果把日期参数的格式改成其他的，SpringMVC还能处理么?

##### 步骤5:更换日期格式 #####

为了能更好的看到程序运行的结果，我们在方法中多添加一个日期参数

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

使用PostMan发送请求，携带两个不同的日期格式，

`http://localhost/dataParam?date=2088/08/08&date1=2088-08-08`

![1630494565970][]

发送请求和数据后，页面会报400，控制台会报出一个错误

Resolved \[org.springframework.web.method.annotation.MethodArgumentTypeMismatchException: Failed to convert value of type ‘java.lang.String’ to required type ‘java.util.Date’; nested exception is org.springframework.core.convert.ConversionFailedException: Failed to convert from type \[java.lang.String\] to type \[java.util.Date\] for value ‘2088-08-08’; nested exception is java.lang.IllegalArgumentException\]

从错误信息可以看出，错误的原因是在将`2088-08-08`转换成日期类型的时候失败了，原因是SpringMVC默认支持的字符串转日期的格式为`yyyy/MM/dd`,而我们现在传递的不符合其默认格式，SpringMVC就无法进行格式转换，所以报错。

解决方案也比较简单，需要使用`@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(yyyy-MM-dd) ==> "+date1);
        return "{'module':'data param'}";
    }

重新启动服务器，重新发送请求测试，SpringMVC就可以正确的进行日期转换了

![1630495221038][]

##### 步骤6:携带时间的日期 #####

接下来我们再来发送一个携带时间的日期，看下SpringMVC该如何处理?

先修改UserController类，添加第三个参数

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

使用PostMan发送请求，携带两个不同的日期格式，

`http://localhost/dataParam?date=2088/08/08&date1=2088-08-08&date2=2088/08/08 8:08:08`

![1630495347289][]

重新启动服务器，重新发送请求测试，SpringMVC就可以将日期时间的数据进行转换

![1630495507353][]

##### 知识点1：@DateTimeFormat #####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>@DateTimeFormat</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>类型</td> 
   <td>形参注解</td> 
  </tr> 
  <tr> 
   <td>位置</td> 
   <td>SpringMVC控制器方法形参前面</td> 
  </tr> 
  <tr> 
   <td>作用</td> 
   <td>设定日期时间型数据格式</td> 
  </tr> 
  <tr> 
   <td>相关属性</td> 
   <td>pattern：指定日期时间格式字符串</td> 
  </tr> 
 </tbody> 
</table>

##### 内部实现原理 #####

讲解内部原理之前，我们需要先思考个问题:

*  前端传递字符串，后端使用日期Date接收
 *  前端传递JSON数据，后端使用对象接收
 *  前端传递字符串，后端使用Integer接收
 *  后台需要的数据类型有很多中
 *  在数据的传递过程中存在很多类型的转换

问:谁来做这个类型转换?

答:SpringMVC

问:SpringMVC是如何实现类型转换的?

答:SpringMVC中提供了很多类型转换接口和实现类

在框架中，有一些类型转换接口，其中有:

*  (1) Converter接口

/**
    *	S: the source type
    *	T: the target type
    */
    public interface Converter<S, T> {
        
        @Nullable
        //该方法就是将从页面上接收的数据(S)转换成我们想要的数据类型(T)返回
        T convert(S source);
    }

**注意:Converter所属的包为`org.springframework.core.convert.converter`**

Converter接口的实现类

![1630496385398][]

框架中有提供很多对应Converter接口的实现类，用来实现不同数据类型之间的转换,如:

请求参数年龄数据（String→Integer）

日期格式转换（String → Date）

*  (2) HttpMessageConverter接口

该接口是实现对象与JSON之间的转换工作

**注意:SpringMVC的配置类把@EnableWebMvc当做标配配置上去，不要省略**

#### 2.6 响应 ####

SpringMVC接收到请求和数据后，进行一些了的处理，当然这个处理可以是转发给Service，Service层再调用Dao层完成的，不管怎样，处理完以后，都需要将结果告知给用户。

比如:根据用户ID查询用户信息、查询用户列表、新增用户等。

对于响应，主要就包含两部分内容：

*  响应页面
 *  响应数据
    
     *  文本数据
     *  json数据

因为异步调用是目前常用的主流方式，所以我们需要更关注的就是如何返回JSON数据，对于其他只需要认识了解即可。

##### 2.6.1 环境准备 #####

*  创建一个Web的Maven项目
 *  pom.xml添加Spring依赖
    
        <?xml version="1.0" encoding="UTF-8"?>
        
        <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
          <modelVersion>4.0.0</modelVersion>
        
          <groupId>com.itheima</groupId>
          <artifactId>springmvc_05_response</artifactId>
          <version>1.0-SNAPSHOT</version>
          <packaging>war</packaging>
        
          <dependencies>
            <dependency>
              <groupId>javax.servlet</groupId>
              <artifactId>javax.servlet-api</artifactId>
              <version>3.1.0</version>
              <scope>provided</scope>
            </dependency>
            <dependency>
              <groupId>org.springframework</groupId>
              <artifactId>spring-webmvc</artifactId>
              <version>5.2.10.RELEASE</version>
            </dependency>
            <dependency>
              <groupId>com.fasterxml.jackson.core</groupId>
              <artifactId>jackson-databind</artifactId>
              <version>2.9.0</version>
            </dependency>
          </dependencies>
        
          <build>
            <plugins>
              <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.1</version>
                <configuration>
                  <port>80</port>
                  <path>/</path>
                </configuration>
              </plugin>
            </plugins>
          </build>
        </project>
 *  创建对应的配置类
    
        public class ServletContainersInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
              
            protected Class<?>[] getRootConfigClasses() {
              
                return new Class[0];
            }
        
            protected Class<?>[] getServletConfigClasses() {
              
                return new Class[]{
              SpringMvcConfig.class};
            }
        
            protected String[] getServletMappings() {
              
                return new String[]{
              "/"};
            }
        
            //乱码处理
            @Override
            protected Filter[] getServletFilters() {
              
                CharacterEncodingFilter filter = new CharacterEncodingFilter();
                filter.setEncoding("UTF-8");
                return new Filter[]{
              filter};
            }
        }
        
        @Configuration
        @ComponentScan("com.itheima.controller")
        //开启json数据类型自动转换
        @EnableWebMvc
        public class SpringMvcConfig {
              
        }
 *  编写模型类User
    
        public class User {
              
            private String name;
            private int age;
            //getter...setter...toString省略
        }
 *  webapp下创建page.jsp
    
        <html>
        <body>
        <h2>Hello Spring MVC!</h2>
        </body>
        </html>
 *  编写UserController
    
        @Controller
        public class UserController {
              
        
            
        }

最终创建好的项目结构如下:

![1630497314131][]

##### 2.6.2 响应页面\[了解\] #####

###### 步骤1:设置返回页面 ######

@Controller
    public class UserController {
        
        
        @RequestMapping("/toJumpPage")
        //注意
        //1.此处不能添加@ResponseBody,如果加了该注入，会直接将page.jsp当字符串返回前端
        //2.方法需要返回String
        public String toJumpPage(){
        
            System.out.println("跳转页面");
            return "page.jsp";
        }
        
    }

###### 步骤2:启动程序测试 ######

此处涉及到页面跳转，所以不适合采用PostMan进行测试，直接打开浏览器，输入

`http://localhost/toJumpPage`

![1630497496785][]

##### 2.6.3 返回文本数据\[了解\] #####

###### 步骤1:设置返回文本内容 ######

@Controller
    public class UserController {
        
        
       	@RequestMapping("/toText")
    	//注意此处该注解就不能省略，如果省略了,会把response text当前页面名称去查找，如果没有回报404错误
        @ResponseBody
        public String toText(){
        
            System.out.println("返回纯文本数据");
            return "response text";
        }
        
    }

###### 步骤2:启动程序测试 ######

此处不涉及到页面跳转，因为我们现在发送的是GET请求，可以使用浏览器也可以使用PostMan进行测试，输入地址`http://localhost/toText`访问

![1630497741388][]

##### 2.6.4 响应JSON数据 #####

###### 响应POJO对象 ######

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

返回值为实体类对象，设置返回值为实体类类型，即可实现返回对应对象的json数据，需要依赖==@ResponseBody注解和@EnableWebMvc==注解

重新启动服务器，访问`http://localhost/toJsonPOJO`

![1630497954896][]

###### 响应POJO集合对象 ######

@Controller
    public class UserController {
        
        
        @RequestMapping("/toJsonList")
        @ResponseBody
        public List<User> toJsonList(){
        
            System.out.println("返回json集合数据");
            User user1 = new User();
            user1.setName("传智播客");
            user1.setAge(15);
    
            User user2 = new User();
            user2.setName("黑马程序员");
            user2.setAge(12);
    
            List<User> userList = new ArrayList<User>();
            userList.add(user1);
            userList.add(user2);
    
            return userList;
        }
        
    }

重新启动服务器，访问`http://localhost/toJsonList`

![1630498084047][]

##### 知识点1：@ResponseBody #####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>@ResponseBody</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>类型</td> 
   <td>方法\类注解</td> 
  </tr> 
  <tr> 
   <td>位置</td> 
   <td>SpringMVC控制器方法定义上方和控制类上</td> 
  </tr> 
  <tr> 
   <td>作用</td> 
   <td>设置当前控制器返回值作为响应体,<br>写在类上，该类的所有方法都有该注解功能</td> 
  </tr> 
  <tr> 
   <td>相关属性</td> 
   <td>pattern：指定日期时间格式字符串</td> 
  </tr> 
 </tbody> 
</table>

**说明:**

*  该注解可以写在类上或者方法上
 *  写在类上就是该类下的所有方法都有@ReponseBody功能
 *  当方法上有@ReponseBody注解后
    
     *  方法的返回值为字符串，会将其作为文本内容直接响应给前端
     *  方法的返回值为对象，会将对象转换成JSON响应给前端

此处又使用到了类型转换，内部还是通过Converter接口的实现类完成的，所以Converter除了前面所说的功能外，它还可以实现:

*  对象转Json数据(POJO -> json)
 *  集合转Json数据(Collection -> json)

[1630463382386]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/1805f467863044558dbd852fd98c1878.png
[1630463816424]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/7e7f15eca6a6443bb3af5a5a80be2e9c.png
[1630463887711]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/ece1e0c90bd74dbaacc72afd042be10d.png
[19a039a1c56f34c34f85bb3da30b2265.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/4d330f93b5634df59fbb290b42fffcf2.png
[1630464489898]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/a656e39ed7254594a5812e1d37bdb486.png
[1630464783034]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/269a43e4c28f459da0481b965ebd7d7c.png
[1630466431549]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/b709f0bb509f46e7bfb03995fff2ca41.png
[1630466555934]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/a4358716ec5741e8a2cd494288bfb402.png
[1630467830654]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/4efbe9ee5a6d4658b45a32f76fae2427.png
[1630467921300]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/491fc7fda0444fbc826de09f3cb3c329.png
[1630468045733]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/367ba42976f24939bb39b159ef1f5418.png
[1630480536510]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/481f35ca8bd94e098c36dd5c5ea92b91.png
[1630480812809]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/78a77b8111a9429a88084db0cde6f565.png
[1630480964421]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/c9117d6e2af84431829afdbf49fb2240.png
[1630481008109]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/76d11cf93bcd4ce691a9872e502799f1.png
[1630481585729]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/555434efb08540e29f0429fe7e827ea1.png
[1630481772035]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/653f7c89bb1944779fb8cfd9cc3dfa67.png
[1630482186745]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/57260f27a1034f509289c5f97d7e8deb.png
[1630482363291]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/26b89d6f1c7342f684b02a87fadd8a38.png
[1630482999626]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/1ca90aafef504e2a85498188b56fce31.png
[1630484283773]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/5b9adbfb9d6e48d9a2ccba960ba68ede.png
[1630484339065]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/a4f508523237447daa43ae1400eaa6fc.png
[1630485135061]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/684c65f3a4e643e4b8872631398d50e4.png
[1630492624684]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/f83e81b03a2d41e389d1b6659ed58ee5.png
[1630493105450]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/5fa232354c47470f8ddcdfd71f815cc5.png
[1630493233550]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/6a19a24a462b44c69d7137080ccc17d4.png
[1630493450694]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/adeda2ed49da404eb229b0254c25554a.png
[1630493501205]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/9dec6ab4f7004c5282b62ac5860d9ffc.png
[1630493561137]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/092f9201a47542cab9d10bf0006c7b91.png
[1630494320917]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/2e0e0461565d48568fc314277e818226.png
[1630494443738]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/e8b0afdfae8349fb92b7b75ae9f396d0.png
[1630494565970]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/34e4be1f44c24e859a8f223e3a8e1b91.png
[1630495221038]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/7124145edc77456b849c7cc3bc969154.png
[1630495347289]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/895b7fd407704d8294297a2bab60b1ab.png
[1630495507353]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/d1c9c3a8da554353849e62df36085562.png
[1630496385398]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/aaf06014d8324acaa4ece90349189273.png
[1630497314131]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/4abf3e6f1016421cab739bb73608d774.png
[1630497496785]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/87a9f77dcfcb424eb1ce626b918d1108.png
[1630497741388]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/fa8f210057284ad990055aaaca07bd89.png
[1630497954896]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/c6f7ade8e41a421bad7c678e31c8d4e1.png
[1630498084047]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/18/25e557c14d4e4633a9086cb3a6b2aed4.png