【SSM框架系列】SpringMVC的请求和响应
request和response
request对象的作用
- 获取请求参数
- 作为域对象存取数据
- 获取请求头
- 请求转发
response功能
- 回写数据，JSON格式字符串
- 页面跳转（请求重定向）
Springmvc仅仅是对上述两个对象进行了封装，所以Springmvc的请求和响应与上面一致。
springmvc响应数据
页面跳转
1）直接返回字符串
返回的是要跳转的资源路径名，资源路径名可以是html、jsp或者是Controller中其他的方法虚拟资源路径。默认是请求转发，如果想要重定向，要写：redirect:资源路径名(不需要带项目名)。
2）返回通过ModelAndView对象
在Controller中方法使用ModelAndView对象并且设置视图名称，并将该对象返回，
这个ModelAndView对象可以是在方法内部new出来的，如下：
@RequestMapping(value="/quick2")
public ModelAndView save2(){
ModelAndView modelAndView = new ModelAndView();
/*
Model 模型 用于封装数据
View 视图 用于展示数据
设置模型数据 key --> value形式存储
modelAndView：这个对象可以直接new出来
也可以在参数上声明，让框架注入
*/
modelAndView.addObject("username","赵丽颖");
//设置视图名称
// 其实就是存入request域对象中
modelAndView.setViewName("success");
return modelAndView;
}
也可以在Controller中方法形参上直接声明一个ModelAndView对象。
这种方式无需自己在方法中创建，框架会帮我们将ModelAndView对象注入，直接使用设置视图名称即可。
@RequestMapping(value="/quick3")
public ModelAndView save3(ModelAndView modelAndView){
modelAndView.addObject("username","赵丽颖");
modelAndView.setViewName("success");
return modelAndView;
}
ModelAndView对象的功能：
上述两种方式获得的ModelAndView对象都可以完成以下两个功能
- 设置视图名。成功设置视图名之后，可以通过返回该对象实现页面跳转。
modelAndView.setViewName("/success.jsp");
- 设置数据模型。设置数据模型后，会将数据存储到request域中，以便后续展示。
modelAndView.addObject(“username”,“赵丽颖”);
使用ModelAndView注意事项：
这种方式只能通过返回ModelAndView对象实现页面跳转，除此之外的其他方式返回字符串（资源路径名称）即可实现页面跳转。
如果使用ModelAndView封装数据，必须通过返回该ModelAndView对象实现页面跳转，否则在跳转后的页面会拿不到数据。
回写数据
直接回写字符串
原始方式：相当于response.getWriter().print(“hello”)，将一个字符串直接写入到前端页面，原页面内容会被覆盖。这种用法建议不用。
Springmvc方式：将需要回写的字符串直接返回，需要通过@ResponseBody注解告知SpringMVC框架，方法返回的字符串不是跳转是直接在http响应体中返回，业务方法返回值也是void
@RequestMapping(value="/quick7")
@ResponseBody //告知SpringMVC框架 不进行视图跳转 直接进行数据响应
public String save7() throws IOException {
return "hello itheima";
}
ResponseBody用法：
- 如果不写该注解，方法的String返回值会被当做一个要跳转的资源名称
- 在方法上添加@ResponseBody注解后，则会将String类型的返回值响应到页面
- 如果是同步请求，会直接在页面上显示，但是会覆盖掉原来页面的内容
- 如果是异步请求，会返回到异步请求的回调函数中
返回对象或集合
方式1
为处理器适配器（RequestMappingHandlerAdapter）配置消息转换器（MappingJackson2HttpMessageConverter），指定使用jackson进行对象或集合的转换。
在spring-mvc.xml中进行如下配置：
<bean class=" org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter ">
<property name="messageConverters">
<list>
<bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
list>
property>
bean>
然后在业务方法中直接返回需要转换的对象或集合即可。此时仍需要@ResponseBody注解，因为在回写数据。
@RequestMapping(value="/quick10")
@ResponseBody
//期望SpringMVC自动将User转换成json格式的字符串
public User save10() throws IOException {
User user = new User();
user.setUsername("赵丽颖");
user.setAge(18);
return user;
}
方式二
可以使用mvc的注解驱动代替上述配置复杂配置
<mvc:annotation-driven/>
这是一个神奇的标签，能帮代替我们完成很多工作，所以使用Springmvc开发，第一步先在配置文件中配置该标签。原理如下：
-
处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。
-
使用
-
所以可以在Springmvc配置文件中使用
-
同时使用
Springmvc把对象通过json形式回写的步骤就变成了如下简单几步：
- 在springmvc配置文件中添加注解驱动
- 在业务方法上添加@Response注解，用于标识该方法会直接回写数据
- 把需要回写的对象或集合直接return
说明：
- 如果视图层使用JSP技术，Controller一般返回ModelAndView
- 如果视图层使用HTML技术，Controller一般返回JSON字符串，可以在HTML发送异步请求，后台响应JSON字符串到Ajax的回调函数中，返回JSON字符串，可以返回对象或集合，让SpringMVC框架转换为JSON字符串
- 需要配置两个地方
- 方法上@ResponseBody
- 配置文件
SpringMVC获取请求数据
Springmvc获取的请求参数类型
客户端请求参数的格式是：name=value&name=value……
服务器端要获得请求的参数，有时还需要进行数据的封装，SpringMVC可以接收如下类型的参数
- 基本类型参数
- POJO类型参数
- 数组类型参数
- 集合类型参数
- 请求头、请求体等等
Springmvc可以把请求参数中的参数值直接赋值给业务方法的形参。
要求：Controller中的业务方法的参数名称要与请求参数的name一致，参数值会自匹配赋值。并且能自动做类型转换。
自动的类型转换是指从String向其他类型的转换。请求地址：
http://localhost:8080/quick11?username=zhangsan&age=12
业务方法代码：
@RequestMapping(value="/quick11")
@ResponseBody
public void save11(String username,int age) throws IOException {
System.out.println(username);
System.out.println(age);
}
其中，请求参数名和业务方法中形参名称必须相同，Springmvc可以自动完成String到其他类型的自动转换。
获得POJO类型参数
要求：Controller中的业务方法形参POJO的属性名与请求参数的name一致，参数值可以自动匹配赋值。并且能自动做类型转换。自动的类型转换是指从String向其他类型的转换。
请求地址：
http://localhost:8080/quick12?username=zhangsan&age=12
业务方法代码：
@Data
public class User {
private String username;
private int age;
}
@RequestMapping(value="/quick12")
@ResponseBody
public void save12(User user) throws IOException {
System.out.println(user);
}
其中，请求参数名和业务方法中形参名称必须相同，Springmvc可以自动完成String到其他类型的自动转换。
获取数组类型参数
Springmvc可以把请求参数中的多个同名参数的值组合成一个数组，直接赋值给业务方法形参中的同名数组字段。
要求：Controller中的业务方法数组名称与请求参数的name一致，参数值可以自动匹配赋值。并且能自动做类型转换。自动的类型转换是指从String向其他类型的转换。
请求地址：
http://localhost:8080/quick13?strs=aaa&strs=bbb&strs=ccc
业务方法代码：
@RequestMapping(value="/quick13")
@ResponseBody
public void save13(String[] strs) throws IOException {
System.out.println(Arrays.asList(strs));
}
获取集合类型参数
Springmvc可以把请求参数中的值赋值赋值给集合类型参数，要将集合参数包装到一个POJO中才可以。
<form action="${pageContext.request.contextPath}/user/quick14" method="post">
<%--表明是第一个User对象的username age--%>
<input type="text" name="userList[0].username"><br/>
<input type="text" name="userList[0].age"><br/>
<input type="text" name="userList[1].username"><br/>
<input type="text" name="userList[1].age"><br/>
<input type="submit" value="提交">
</form>
@Data
public class VO {
private List<User> userList;
}
@RequestMapping(value="/quick14")
@ResponseBody
public void save14(VO vo) throws IOException {
System.out.println(vo);
}
其中input标签的name值为save14方法对象的字段值。
更简单的办法就是在User类中添加一个属性userList，在toString()方法中避免递归即可。
获取集合类型参数-json
当使用ajax提交时，可以指定contentType为application/json，那么在方法参数位置使用@RequestBody可以直接接收json格式的集合数据，Springmvc可以自动封装到形参List里面，而不需要使用POJO对象封装List。此处没有名字一致的要求。
<script src="${pageContext.request.contextPath}/js/jquery-3.3.1.js"></script>
<script>
var userList = new Array();
userList.push({username:"赵丽颖",age:18});
userList.push({username:"迪丽热巴",age:28});
$.ajax({
type:"POST",
url:"${pageContext.request.contextPath}/user/quick15",
data:JSON.stringify(userList),
contentType:"application/json;charset=utf-8"
});
</script>
@RequestMapping(value="/quick15")
@ResponseBody
public void save15(@RequestBody List<User> userList) throws IOException {
System.out.println(userList);
}
出现无法访问静态资源的情况，可以使用SpringMVC的万能模式解决。
<mvc:annotation-driven/>
<mvc:default-servlet-handler/>
使用@RequestBody获取请求体中的数组类型的json数据，需要在前端配合ContentType=“application/json;charset=utf-8”使用。如果发送的Json数据是数组对象，需要在业务方法形参使用一个名字任意的JavaBean的list对象接收。
如果发送的json数据是单个对象，则不需要使用@RequestBody和设置ContentType：
- 前后台同时设置或者只在后台设置@RequestBody都会报错，
- 前台只设置ContentType数据无法封装到javaBean中
结论：@RequestBody和ContentType配合使用成对出现，用来处理集合数据的封装。
静态资源访问的开启
当有静态资源需要加载时，比如jquery文件，通过谷歌开发者工具抓包发现，没有加载到jquery文件。
原因是SpringMVC的前端控制器DispatcherServlet的url-pattern配置的是/，代表对所有的非JSP资源都进行拦截过滤匹配对应的资源路径和业务方法，但是静态资源没有与之匹配的资源路径和业务方法。
可以通过以下两种方式指定放行静态资源：
- 在spring-mvc.xml配置文件中指定放行的资源
<mvc:resources mapping="/js/**" location="/js/"/>
<mvc:resources mapping="/img/**" location="/js/"/>
- 使用mvc:default-servlet-handler/标签
<mvc:annotation-driven/>
<mvc:default-servlet-handler/>
解决POST请求相应乱码
当post请求时，数据会出现乱码，我们可以设置一个过滤器来进行编码的过滤。
<filter>
<filter-name>encodingFilterfilter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilterfilter-class>
<init-param>
<param-name>encodingparam-name>
<param-value>utf-8param-value>
init-param>
<init-param>
<param-name>forceEncodingparam-name>
<param-value>trueparam-value>
init-param>
filter>
<filter-mapping>
<filter-name>encodingFilterfilter-name>
<url-pattern>/*url-pattern>
filter-mapping>
上述配置可以解决配置可以解决整个项目的POST请求乱码，项目的相应乱码可以在Springmvc配置文件中进行如下配置：
<mvc:annotation-driven>
<mvc:message-converters>
<bean class="org.springframework.http.converter.StringHttpMessageConverter">
<constructor-arg value="utf-8"/>
bean>
mvc:message-converters>
mvc:annotation-driven>
上述两个配置配合使用，可以解决整个项目的请求和相应乱码问题
解决响应乱码的另一种方式，不推荐使用。
@ResponseBody
@RequestMapping(value = "/test5_1",
consumes = "application/x-www-form-urlencoded;charset=utf-8")
public String test5_1( User user){
System.out.println(user);
return "赵丽颖";
}
参数绑定注解@RequestParam
当请求参数名称与Controller的业务方法参数名称不一致时，就需要通过@RequestParam注解显示的绑定
<form action="${pageContext.request.contextPath}/quick16" method="post">
<input type="text" name="name"><br>
<input type="submit" value="提交"><br>
form>
@RequestMapping(value="/quick16")
@ResponseBody
public void save16(@RequestParam(value="name",required = false) String username) throws IOException {
System.out.println(username);
}
@RequestParam用于解决请求参数和业务方法形参名称不一致的问题。其required属性默认为true，要求必须携带相应的请求参数，可以携带相应的参数发送请求或者设置required = false
Restful风格的参数的获取
Restful是一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。主要用于客户端和服务器交互类的软件，基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存机制等。
Restful风格的请求是使用“url+请求方式”表示一次请求目的的，HTTP 协议里面四个表示操作方式的动词如下：
GET：用于获取资源
POST：用于新建资源
PUT：用于更新资源
DELETE：用于删除资源
例如：
/user/1 GET ： 得到 id = 1 的 user
/user/1 DELETE： 删除 id = 1 的 user
/user/1 PUT： 更新 id = 1 的 user
/user POST： 新增 user
上述url地址/user/1中的1就是要获得的请求参数，在SpringMVC中可以使用占位符进行参数绑定。
地址/user/1可以写成/user/{id}，占位符{id}对应的就是1的值。
在业务方法中我们可以使用@PathVariable注解进行占位符的匹配获取工作。
// http://localhost:8080/quick17/zhangsan
@RequestMapping(value="/quick17/{name}")
@ResponseBody
public void save17(@PathVariable(value="name") String username) throws IOException {
System.out.println(username);
}
自定义类型转换器
SpringMVC 默认已经提供了一些常用的类型转换器，例如客户端提交的字符串转换成int型进行参数设置。
但是不是所有的数据类型都提供了转换器，没有提供的就需要自定义转换器，例如：特殊格式的日期类型的数据就需要自定义转换器。
自定义转换器步骤：
1. 编写类实现Converter接口，接口泛型<源类型, 目标类型>，实现convert方法
接口全包名org.springframework.core.convert.converter.Converter
2. 在springmvc配置文件中装配自定义类型转换器（注入ConversionServiceFactoryBean的converters属性)
ConversionServiceFactoryBean的bean的id要注意，不要与系统重名
3. 在springmvc配置文件的编写万能Date转换类
public class DataConverter implements Converter<String, Date> {
@Override
public Date convert(String s) {
//定义simpleDataFormat对象
//配置自定义Date类型转换器之后，系统内置Date类型转换器将失效，所以要把系统默认格式一起处理了
SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd");
//判断格式 1999/01/01
char c4 = s.charAt(4);
char c7 = s.charAt(7);
if ('-' == c4 && '-' == c7) {
sdf = new SimpleDateFormat("yyyy-MM-dd");
} else if ('.' == c4 && '.' == c7) {
sdf = new SimpleDateFormat("yyyy.MM.dd");
} else if ('年' == c4 && '月' == c7) {
sdf = new SimpleDateFormat("yyyy年MM月dd日");
}
Date date = null;
try {
date = sdf.parse(s);
} catch (ParseException e) {
e.printStackTrace();
}
return date;
}
}
在springmvc配置文件中配置
<!-- 引入自定义的类型转换器所述的工厂Bean -->
<mvc:annotation-driven conversion-service="conversionService1"/>
<!-- 装配springmvc的类型转换工厂对象，将自定的DataConverter注入其属性converters -->
<bean id="conversionService1" class="org.springframework.context.support.ConversionServiceFactoryBean">
<property name="converters">
<list>
<bean class="cs.wy.converter.DataConverter"/>
</list>
</property>
</bean>
获取Servlet相关API
SpringMVC支持使用原始ServletAPI对象作为控制器方法的参数进行注入，常用的对象如下：
-
HttpServletRequest
-
HttpServletResponse
-
HttpSession
代码如下：
@RequestMapping(value="/quick19")
@ResponseBody
public void save19(HttpServletRequest request, HttpServletResponse response, HttpSession session) throws IOException {
System.out.println(request);
System.out.println(response);
System.out.println(session);
}
获取请求头信息
使用@RequestHeader可以获得请求头信息，相当于request.getHeader(name)
@RequestHeader注解的属性如下：
-
value：请求头的名称
-
required：是否必须携带此请求头
@RequestMapping(value="/quick20")
@ResponseBody
public void save20(@RequestHeader(value = "User-Agent",required = false) String user_agent) throws IOException {
System.out.println(user_agent);
}
使用@CookieValue可以获得指定Cookie的值
@CookieValue注解的属性如下：
-
value：指定cookie的名称
-
required：是否必须携带此cookie
@RequestMapping(value="/quick21")
@ResponseBody
public void save21(@CookieValue(value = "JSESSIONID") String jsessionId) throws IOException {
System.out.println(jsessionId);
}