4. 请求与响应

1. 设置请求映射路径

1.1 问题分析

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

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

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

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

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

‍

1.2 设置映射路径

步骤一 ： 修改 Controller

​

image

​

‍

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

步骤二 ： 优化路径配置

优化方案​

​

image

​

注意:

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

扩展小知识:

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

‍

2. 请求参数

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

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

• GET
• POST

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

2.1 参数传递

‍

GET 发送单个参数

‍

GET 发送多个参数

‍

POST 请求中文乱码

解决方案 ： 配置过滤器

 //乱码处理
    @Override
    protected Filter[] getServletFilters() {
        CharacterEncodingFilter filter = new CharacterEncodingFilter();
        filter.setEncoding("UTF-8");
        return new Filter[]{filter};
    }

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

‍

3. 五种类型参数传递

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

3.1 普通参数

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

当前端参数和后端参数参数不同时 ， 可使用@RequesParam 注解解决

‍

​

image

​

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

‍

3.2 POJO 数据类型

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

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

​

image

​

‍

注意:

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

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 属性参数

注意:

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

‍

3.4 数组类型参数

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

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

​

image

​

‍

3.5 集合类型参数

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

​

image

​

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

知识点 1：@RequestParam

‍

4. JSON 数据传输参数

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

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

• json 普通数组（["value1","value2","value3",...]）
• json 对象（{key1:value1,key2:value2,...}）
• json 对象数组（[{key1:value1,...},{key2:value2,...}]）

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

4.1 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 数据

​

image

​

步骤 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:启动运行程序

​

image

​

‍

4.2 JSON 对象数据

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

‍

4.3 JSON 对象数据

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

请求和数据的发送:

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

‍

4.4 小结

‍

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

(1)导入 jackson 包

(2)使用 PostMan 发送 JSON 数据

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

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

‍

4.5 知识点 1：@EnableWebMvc

4.6 知识点 2：@RequestBody

4.7 @RequestBody 与@RequestParam 区别

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

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

​

image

​

步骤 4:查看控制台

​

image

​

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

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

步骤 5:更换日期格式

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

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

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

​

image

​

发送请求和数据后，页面会报 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 就可以正确的进行日期转换了

步骤 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​

​

image

​

知识点 1：@DateTimeFormat

内部实现原理

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

• 前端传递字符串，后端使用日期 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 接口的实现类

​

image

​

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

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

日期格式转换（String → Date）

• (2) HttpMessageConverter 接口

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

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

4. 响应

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

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

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

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

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

知识点 1：@ResponseBody

说明:

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

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

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