SpringMVC03 —— SpringMVC的请求和响应
往期文章
Spring01 —— Spring概念及快速入门
Spring02 —— Spring配置文件详解和依赖注入
Spring03 —— SpringAPI和在Spring中配置数据源
Spring04 —— Spring的注解开发
Spring05 —— Spring集成Junit
Spring06 —— Spring集成web环境
SpringMVC01 —— SpringMVC简介&快速入门
SpringMVC02 —— SpringMVC的各组件详解
本文目录
- 往期文章
- SpringMVC的请求和响应
-
- 一、SpringMVC的数据响应
-
- 1.1、页面跳转
-
- 1.1.1、页面跳转——返回字符串形式
- 1.1.2、页面跳转——返回ModelAndView形式1
- 1.1.3、页面跳转——返回ModelAndView形式2
- 1.1.4、页面跳转——返回ModelAndView形式3
- 1.2、回写数据
-
- 1.2.1、回写数据——直接回写字符串
- 1.2.2、回写数据——直接回写json数据
- 1.2.3、回写数据——返回对象或集合
- 1.3、知识小结
- 二、SpringMVC的请求
-
- 2.1、获得请求参数
-
- 2.1.1、获得基本类型参数
- 2.1.2、获得POJO类型参数
- 2.1.3、获得数组类型的参数
- 2.1.4、获得集合类型参数1
- 2.1.5、获得集合类型参数2
- 2.1.6、静态资源访问的开启
- 2.1.7、配置全局乱码过滤器
- 2.1.8、参数绑定注解@RequestParam
- 2.1.9、Restful风格参数的获取
- 2.1.10、自定义类型转换器
- 2.1.11、获得Servlet相关API
- 2.1.12、获得请求头消息
- 2.2、文件上传
-
- 2.2.1、客户端表单实现
- 2.2.2、文件上传原理
- 2.2.3、单文件上传
- 2.2.4、多文件上传
- 2.3、知识小结
SpringMVC的请求和响应
一、SpringMVC的数据响应
响应方式分为两种方式:
1、 页面跳转
直接返回字符串
通过ModelAndView对象返回
2、 回写数据
直接返回字符串
返回对象或集合
1.1、页面跳转
1.1.1、页面跳转——返回字符串形式
1.1.2、页面跳转——返回ModelAndView形式1
@RequestMapping("/quick2")public ModelAndView save2(){ /* * Model : 模型 封装数据 * View:视图 展示数据 * */ ModelAndView modelAndView = new ModelAndView(); // 设置模型数据 modelAndView.addObject("username","zhangwuji"); // 设置视图名称 modelAndView.setViewName("success"); return modelAndView;}
修改success.jsp文件
运行项目:
1.1.3、页面跳转——返回ModelAndView形式2
在Controller中方法形参上直接声明ModelAndView,无需在方法中自己创建,在方法中直接使用该对象设置 视图,同样可以跳转页面
@RequestMapping("/quick3")public ModelAndView save3(ModelAndView modelAndView){ modelAndView.addObject("username","张无忌"); modelAndView.setViewName("success"); return modelAndView;}
SpringMVC对方法的参数可以进行相应的注入,当解析该方法时发现需要一个ModelAndView 那么SpringMVC就会提供一个ModelAndView
还可以只设置模型model 返回字符串
@RequestMapping("/quick4")public String save4(Model model){ // 设置模型 model.addAttribute("username","戴尔"); // 返回逻辑视图名称 return "success";}
1.1.4、页面跳转——返回ModelAndView形式3
在Controller方法的形参上可以直接使用原生的HttpServeltRequest对象,只需声明即可
@RequestMapping("/quick5")public String save4(HttpServletRequest request){ request.setAttribute("username","赵敏"); // 返回逻辑视图名称 return "success";}
1.2、回写数据
1.2.1、回写数据——直接回写字符串
1、通过SpringMVC框架注入的response对象,使用response.getWriter().print(“hello world”) 回写数据,此时不 需要视图跳转,业务方法返回值为void
2、将需要回写的字符串直接返回,但此时
需要通过@ResponseBody注解
告知SpringMVC框架,方法返回的字符 串不是跳转是直接在http响应体中返回
@RequestMapping("/quick6")public void save6(HttpServletResponse response) throws IOException { response.setContentType("text/html;charset=utf-8"); response.getWriter().write("你好!");}
@RequestMapping("/quick7")@ResponseBody // 使用该注解 告知Spring框架直接返回字符串public String save7() { return "hello world!";}
1.2.2、回写数据——直接回写json数据
@RequestMapping(value = "/quick8")@ResponseBodypublic String save8() { return "{\"username\":\"zhangsan\",\"age\":18}"; // 里面的引号需要进行转义}
手动拼接json格式字符串的方式很麻烦,开发中往往要将复杂的java对象转换成json格式的字符串,我们可以 使用web阶段学习过的json转换工具jackson进行转换,通过jackson转换json格式字符串,回写字符串
导入jackson相关坐标
<dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-core</artifactId> <version>2.9.0</version></dependency><dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.9.0</version></dependency><dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-annotations</artifactId> <version>2.9.0</version></dependency>
@RequestMapping(value = "/quick9")@ResponseBodypublic String save9() throws IOException { User user = new User("张三",20,"东莞"); // 使用json转换工具将对象转换为json字符串 ObjectMapper mapper = new ObjectMapper(); String json = mapper.writeValueAsString(user); return json;}
测试:
上述每个对象都要自己转成json 造成代码重复太多 ,那么SpringMVC框架就提供了帮我们转json字符串的功能,但是需要我们进行相关配置
1.2.3、回写数据——返回对象或集合
@RequestMapping(value = "/quick10") @ResponseBody // 期望SpringMVC框架自动将user对象转换为json格式字符串并返回 public User save10() { User user = new User("zhansan",20,"newyork"); return user; }
通过SpringMVC帮助我们对对象或集合进行json字符串的转换并回写,
为处理器适配器配置消息转换参数
,指 定使用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就可以返回json格式的字符串,但是这样配置比较麻烦,配置的代码比较多, 因此,我们可以使用mvc的注解驱动代替上述配置
在 SpringMVC 的各个组件中,处理器映射器
、处理器适配器
、视图解析器
称为 SpringMVC 的三大组件
使用 自动加载 RequestMappingHandlerMapping(处理映射器)和
RequestMappingHandlerAdapter( 处 理 适 配 器 ),可用在Spring-xml.xml配置文件中使用
替代注解处理器和适配器的配置。
同时使用 默认底层就会集成jackson进行对象或集合的json格式字符串的转换
所以我们只需要在spring-mvc.xml文件中配置SpringMVC的注解驱动·即可
首先引入mvc的命名空间和约束路径:
<mvc:annotation-driven />
测试:
1.3、知识小结
1) 页面跳转
直接返回字符串
通过ModelAndView对象返回
2) 回写数据
直接返回字符串
HttpServletResponse 对象直接写回数据,HttpServletRequest对象带回数据,Model对象带回数据或者
@ResponseBody将字符串数据写回
返回对象或集合
@ResponseBody+
二、SpringMVC的请求
请求参数的类型有哪些:
客户端请求参数的格式是:name=value&name=value……
服务器端要获得请求的参数,有时还需要进行数据的封装
SpringMVC可以接受的参数类型:
- 基本类型参数
- POJO类型参数 (实体bean)
- 数组类型参数
- 集合类型参数
2.1、获得请求参数
2.1.1、获得基本类型参数
Controller中的业务方法的
参数名称要与请求参数的name一致,参数值会自动映射匹配
。并且能自动做类型 转换;自动的类型转换是指从String向其他类型的转换
@Controller@RequestMapping("/person")public class PersonController { @RequestMapping("/p1") @ResponseBody // 表示不进行页面跳转 回写的数据为空 public void test1(String username,int age){ System.out.println(username); System.out.println(age); // SpringMVC框架会自动将获取到的string类型的age转换为int类型的age }}
访问路径 携带参数:http://localhost:8080/spring_mvc/person/p1?username=zhangsan&age=20
观察控制台打印:
2.1.2、获得POJO类型参数
客户端发送的数据到达服务端之后,SpringMVC要将这些参数封装到一个实体当中。原先我们要将请求参数封装到实体当中是怎样做的?通过getParamterMap获取参数map集合,然后通过beanUtils进行实体封装。
但是这些操作在SpringMVC框架中都已经进行了封装,我们只需要保证:
Controller中的业务方法的POJO参数的属性名与请求参数的name一致,参数值会自动映射匹配。
首先创建一个实体类Person
public class Person { private String name; private int 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; }}
@RequestMapping("/p2")@ResponseBodypublic void test2(Person person){ System.out.println(person);}
测试: 携带参数?name=xxx&age=xx
2.1.3、获得数组类型的参数
Controller中的业务方法数组名称与请求参数的name一致,参数值会自动映射匹配。
@RequestMapping("/p3")@ResponseBodypublic void test3(String[] strs){ // 数组默认打印的是地址 所以我们需要将数组转为list集合进行打印 System.out.println(Arrays.asList(strs));}
访问需要携带参数 且参数名都叫strs
http://localhost:8080/spring_mvc/person/p3?strs=a&strs=b&strs=c
2.1.4、获得集合类型参数1
获得集合参数时,要将集合参数包装到一个POJO中才可以。
所以需要先创建一个实体VO
public class VO { private List<Person> personList; public List<Person> getPersonList() { return personList; } public void setPersonList(List<Person> personList) { this.personList = personList; } @Override public String toString() { return "VO{" + "personList=" + personList + '}'; }}
后端代码:
@RequestMapping(value = "/p4")@ResponseBodypublic void test4(VO vo){ System.out.println(vo);}
前端代码:
Title
2.1.5、获得集合类型参数2
当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以直接接 收集合数据而无需使用POJO进行包装
前端代码:
引入jquery
function sendAjax() { var personList = new Array(); personList.push({name: "zhangsan", age: 18}); personList.push({name: "lisi", age: 28}); // 发送ajax请求 $.ajax({ type: "POST", url: "${pageContext.request.contextPath}/person/p5", data: JSON.stringify(personList), contentType: "application/json;charset=utf-8" }); } Title
后端代码:
@RequestMapping("/p5")@ResponseBodypublic void test5(@RequestBody List<Person> personList){ System.out.println(personList);}
这里可能会报错 jquery文件不能获取需要放行静态资源
在spring-mvc.xml文件中指定资源进行放行
重新部署项目进行测试:
2.1.6、静态资源访问的开启
当有静态资源需要加载时,比如jquery文件,通过谷歌开发者工具抓包发现,没有加载到jquery文件,原因是 SpringMVC的前端控制器DispatcherServlet的url-pattern配置的是/,代表对所有的资源都进行过滤操作
,我们可以 通过以下两种方式指定放行静态资源:
解决方法:
1、在spring-mvc.xml配置文件中指定放行的资源
2、使用 标签
2.1.7、配置全局乱码过滤器
当post请求时,数据会出现乱码,我们可以设置一个过滤器来进行编码的过滤。
配置全局的filter CharacterEncodingFilter
<filter> <filter-name>characterEncodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>utf-8</param-value> </init-param></filter><filter-mapping> <filter-name>characterEncodingFilter</filter-name> <url-pattern>/*</url-pattern></filter-mapping>
配置全局乱码过滤器之前:
访问form.jsp
配置全局乱码过滤器:
2.1.8、参数绑定注解@RequestParam
当请求的参数名称与Controller的业务方法参数名称不一致时,就需要通过@RequestParam注解显示的绑定
后端代码:
@RequestMapping("/p6")@ResponseBodypublic void test6(@RequestParam(value = "name",required = false,defaultValue = "张三") String username){ System.out.println(username);}
@RequestParam注解的三个属性:
1、value 参数绑定
2、required 默认值为true 表示是否必须要携带该参数
3、defaultValue 默认值,当设置了默认值那么required就会失效
2.1.9、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注解进行 占位符的匹配获取工作。
后端代码:
// localhost:8080/person/zhangwuji@RequestMapping("/p7/{name}")@ResponseBodypublic void test7(@PathVariable(value = "name") String username){ System.out.println(username);}
测试:
2.1.10、自定义类型转换器
SpringMVC 默认已经提供了一些常用的类型转换器,例如客户端提交的字符串转换成int型进行参数设置。
但是不是所有的数据类型都提供了转换器,没有提供的就需要自定义转换器,例如:日期类型的数据就需要自 定义转换器。
自定义类型转换器步骤:
1、定义转换器类实现Converter接口
2、在配置文件中声明转换器
3、在中引用转换器
后端代码:
@RequestMapping("/p8")@ResponseBodypublic void test8(Date date){ System.out.println(date);}
当Controller中的业务方法的参数名称要与请求参数的name一致,参数值会自动映射匹配。并且能自动做类型转换,显然这里要将字符串形式的时间转换为日期格式:
访问:http://localhost:8080/spring_mvc/person/p8?date=2022/4/6
但是换种格式访问
所以我们自定义日期类型转换器:
【1】自定义转换器类实现Converter接口
package com.zhou.mvc.converter;import org.springframework.core.convert.converter.Converter;import java.text.ParseException;import java.text.SimpleDateFormat;import java.util.Date;/** * @author it春和 * @create 2022-04-06 11:26 */public class DateConverter implements Converter<String, Date> { public Date convert(String source) { // 将日期字符串转换成日期对象并返回 SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd"); Date date = null; try { date = simpleDateFormat.parse(source); } catch (ParseException e) { e.printStackTrace(); } return date; }}
【2】声明自定义转换器
<bean id="conversionService2" class="org.springframework.context.support.ConversionServiceFactoryBean"> <property name="converters"> <list> <bean class="com.zhou.mvc.converter.DateConverter" /> </list> </property> </bean>
【3】在annotation-driven中引用转换器
<mvc:annotation-driven conversion-service="conversionService2"/>
【4】部署测试:
在开发中自定义类型转换器用的比较少,但是一些特殊需求的时候会用的,所以还是要掌握这个知识点!
2.1.11、获得Servlet相关API
SpringMVC支持使用原始ServletAPI对象作为控制器方法的参数进行注入,常用的对象如下:
HttpServletRequest
HttpServletResponse
HttpSession
@RequestMapping("/p9")@ResponseBodypublic void test9(HttpServletRequest request, HttpServletResponse response, HttpSession session){ System.out.println(request); System.out.println(response); System.out.println(session);}
2.1.12、获得请求头消息
使用@RequestHeader可以获得请求头信息,相当于web阶段学习的request.getHeader(name)
@RequestHeader注解的属性如下:
value:请求头的名称
required:是否必须携带此请求头
@RequestMapping("/p10")@ResponseBodypublic void test10(@RequestHeader(value = "User-Agent",required = false) String user_agent){ System.out.println(user_agent);}
使用@CookieValue可以获得指定Cookie的值
@CookieValue注解的属性如下:
value:指定cookie的名称
required:是否必须携带此cookie
@RequestMapping("/p11") @ResponseBody public void test11(@CookieValue(value = "JSESSIONID") String jsessionID){ System.out.println(jsessionID); }
2.2、文件上传
2.2.1、客户端表单实现
文件上传客户端表单需要满足: 文件上传三要素
表单项type=“file”
表单的提交方式是post
表单的enctype属性是多部分表单形式
,即enctype=“multipart/form-data”
新建一个jsp
文件上传 名称:
文件:
2.2.2、文件上传原理
2.2.3、单文件上传
单文件上传步骤:
1、导入fileupload和io坐标
2、配置文件上传解析器
3、编写文件上传代码
【1】添加依赖
<dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.3.1</version></dependency><dependency> <groupId>commons-io</groupId> <artifactId>commons-io</artifactId> <version>2.3</version></dependency>
【2】配置文件上传解析器spring-mvc.xml
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <property name="defaultEncoding" value="UTF-8"/> <property name="maxUploadSize" value="5242800"/> <property name="maxUploadSizePerFile" value="5242800"/> </bean>
【3】编写文件上传代码
@RequestMapping("/p12")@ResponseBodypublic void test12(String name, MultipartFile upload) throws IOException { System.out.println(name); // 获得文件名称 String originalFilename = upload.getOriginalFilename(); // 保存文件 upload.transferTo(new File("d:\\upload\\"+originalFilename));}
注意:
测试:
2.2.4、多文件上传
多文件上传,只需要将页面修改为多个文件上传项,将方法参数MultipartFile类型修改为MultipartFile[]即可
前端代码:
后台代码:
重新部署测试:
2.3、知识小结
SpringMVC实现数据请求方式:
基本数据类型参数
参数名保持一致
POJO类型参数
实体的属性名和参数的名称保持一致即可
数组类型参数
数组名称和请求参数名称保持一致
集合类型参数
先封装实体 使用ajax请求&使用@RequestBody则不需要封装实体
SpringMVC获取数据的细节:
中文乱码问题
CharacterEncodingFilter
@RequestParam和@PathVariable
@RequestParam参数名的匹配,@PathVariable是参数占位符
自定义类型转换器
获得Servlet相关API
@RequestHeader和@CookieValue
文件上传