1. SpringMVC的数据响应

1.1 SpringMVC的数据响应方式

1) 页面跳转

  • 直接返回字符串
  • 通过ModelAndView对象返回
    2) 回写数据
  • 直接返回字符串
  • 返回对象或集合

1.2 页面跳转

1. 返回字符串形式

直接返回字符串:此种方式会将返回的字符串与视图解析器的前后缀拼接后跳转。

04_MVC的请求和响应 - 图1

2. 返回ModelAndView对象

  1. @RequestMapping(value = "/quick4")
  2. public String save4(Model model) {
  3. model.addAttribute("username", "落霞与孤鹜齐飞");
  4. return "success";
  5. }
  6. @RequestMapping(value = "/quick3")
  7. public ModelAndView save3(ModelAndView modelAndView) {
  8. modelAndView.addObject("username", "itheima");
  9. modelAndView.setViewName("success"); // /jsp/success.jsp
  10. return modelAndView;
  11. }
  12. @RequestMapping(value = "/quick2")
  13. public ModelAndView save2() {
  14. /*
  15. Model:模型 作用封装数据
  16. View:视图 作用展示数据
  17. */
  18. ModelAndView modelAndView = new ModelAndView();
  19. //设置模型数据
  20. modelAndView.addObject("username", "itcast");
  21. //设置视图名称
  22. modelAndView.setViewName("success"); // /jsp/success.jsp
  23. return modelAndView;
  24. }

3. 向request域存储数据

在进行转发时,往往要向request域中存储数据,在jsp页面中显示,那么Controller中怎样向request域中存储数据呢?
① 通过SpringMVC框架注入的request对象setAttribute()方法设置

  1. @RequestMapping(value = "/quick5")
  2. public String save5(HttpServletRequest req) {
  3. req.setAttribute("username", "落霞与孤鹜齐飞");
  4. return "success";
  5. }

② 通过ModelAndView的addObject()方法设置

  1. @RequestMapping("/quick3")
  2. public ModelAndView quickMethod3(){
  3. ModelAndView modelAndView = new ModelAndView();
  4. modelAndView.setViewName("forward:/WEB-INF/views/index.jsp");
  5. modelAndView.addObject("name","lisi");
  6. return modelAndView;
  7. }

1.3 回写数据

1. 直接返回字符串

Web基础阶段,客户端访问服务器端,如果想直接回写字符串作为响应体返回的话,只需要使用response.getWriter().print(“hello world”) 即可,那么在Controller中想直接回写字符串该怎样呢?
① 通过SpringMVC框架注入的response对象,使用response.getWriter().print(“hello world”) 回写数据,此时不需要视图跳转,业务方法返回值为void。

  1. /*回写数据*/
  2. @RequestMapping(value = "/quick6")
  3. public void save6(HttpServletResponse response) throws IOException {
  4. response.getWriter().print("hello itcast");
  5. }

② 将需要回写的字符串直接返回,但此时需要通过@ResponseBody注解告知SpringMVC框架,方法返回的字符串不是跳转是直接在http响应体中返回。

  1. @RequestMapping(value = "/quick7")
  2. @ResponseBody //告知SpringMVC框架 不进行视图跳转 直接进行数据响应
  3. public String save7() throws IOException {
  4. return "hello itheima";
  5. }

在异步项目中,客户端与服务器端往往要进行json格式字符串交互,此时我们可以手动拼接json字符串返回。

  1. @RequestMapping(value = "/quick8")
  2. @ResponseBody
  3. public String save8() throws IOException {
  4. return "{\"username\":\"zhangsan\",\"age\":18}";
  5. }

上述方式手动拼接json格式字符串的方式很麻烦,开发中往往要将复杂的java对象转换成json格式的字符串,我们可以使用web阶段学习过的json转换工具jackson进行转换,导入jackson坐标。

  1. <dependency>
  2. <groupId>com.fasterxml.jackson.core</groupId>
  3. <artifactId>jackson-databind</artifactId>
  4. <version>2.9.0</version>
  5. </dependency>
  6. <dependency>
  7. <groupId>com.fasterxml.jackson.core</groupId>
  8. <artifactId>jackson-annotations</artifactId>
  9. <version>2.9.0</version>
  10. </dependency>

不过我这个地方使用的阿里的

  1. <dependency>
  2. <groupId>com.alibaba</groupId>
  3. <artifactId>fastjson</artifactId>
  4. <version>1.2.62</version>
  5. </dependency>
  1. @RequestMapping(value = "/quick9")
  2. @ResponseBody
  3. public String save9() throws IOException {
  4. User user = new User();
  5. user.setUsername("lisi55555555");
  6. user.setAge(30);
  7. //使用json的转换工具将对象转换成json格式字符串在返回
  8. // ObjectMapper objectMapper = new ObjectMapper();
  9. // String json = objectMapper.writeValueAsString(user);
  10. String json = JSON.toJSONString(user);
  11. return json;
  12. }

2. 返回对象或集合

通过SpringMVC帮助我们对对象或集合进行json字符串的转换并回写,为处理器适配器配置消息转换参数,指定使用jackson进行对象或集合的转换,因此需要在spring-mvc.xml中进行如下配置:

  1. <!--配置处理器映射器-->
  2. <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
  3. <property name="messageConverters">
  4. <list>
  5. <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
  6. </list>
  7. </property>
  8. </bean>
  1. @RequestMapping(value = "/quick10")
  2. @ResponseBody
  3. //期望SpringMVC自动将User转换成json格式的字符串
  4. public User save10() throws IOException {
  5. User user = new User();
  6. user.setUsername("lisi777777user");
  7. user.setAge(32);
  8. return user;
  9. }

在方法上添加@ResponseBody就可以返回json格式的字符串,但是这样配置比较麻烦,配置的代码比较多,因此,我们可以使用mvc的注解驱动代替上述配置

  1. <!--mvc的注解驱动-->
  2. <mvc:annotation-driven/>

在 SpringMVC 的各个组件中,处理器映射器处理器适配器视图解析器称为 SpringMVC 的三大组件。使用<mvc:annotation-driven>自动加载 RequestMappingHandlerMapping(处理映射器)RequestMappingHandlerAdapter( 处 理 适 配 器 ),可用在Spring-xml.xml配置文件中使用<mvc:annotation-driven>替代注解处理器和适配器的配置。
同时使用<mvc:annotation-driven>默认底层就会集成jackson进行对象或集合的json格式字符串的转换。

2. SpringMVC 获得请求数据

2.1 获得请求参数

客户端请求参数的格式是:name=value&name=value… …
服务器端要获得请求的参数,有时还需要进行数据的封装,SpringMVC可以接收如下类型的参数:

  • 基本类型参数
  • POJO类型参数
  • 数组类型参数
  • 集合类型参数

2.2 获得基本类型参数

Controller中的业务方法的参数名称要与请求参数的name一致,参数值会自动映射匹配。
http://localhost:8080/itheima_springmvc1/quick9?username=zhangsan&age=12

  1. @RequestMapping(value = "/quick11")
  2. @ResponseBody
  3. public void save11(String username, int age) {
  4. System.out.println(username);
  5. System.out.println(age);
  6. }

2.3 获得POJO类型参数

Controller中的业务方法的POJO参数的属性名与请求参数的name一致,参数值会自动映射匹配
http://localhost:8080/itheima_springmvc1/quick9?username=zhangsan&age=12

  1. public class User {
  2. private String username;
  3. private int age;
  4. getter/setter
  5. }
  6. @RequestMapping("/quick10")
  7. @ResponseBody
  8. public void quickMethod10(User user) throws IOException {
  9. System.out.println(user);
  10. }

2.4 获得数组类型参数

Controller中的业务方法数组名称与请求参数的name一致,参数值会自动映射匹配
http://localhost:8080/itheima_springmvc1/quick11?strs=111&strs=222&strs=333

  1. @RequestMapping("/quick11")
  2. @ResponseBody
  3. public void quickMethod11(String[] strs) throws IOException {
  4. System.out.println(Arrays.asList(strs));
  5. }

2.5 获得集合类型参数

获得集合参数时,要将集合参数包装到一个POJO中才可以
先弄一个表单

  1. <form action="${pageContext.request.contextPath}/quick12" method="post">
  2. <input type="text" name="userList[0].username"><br>
  3. <input type="text" name="userList[0].age"><br>
  4. <input type="text" name="userList[1].username"><br>
  5. <input type="text" name="userList[1].age"><br>
  6. <input type="submit" value="提交"><br>
  7. </form>
  1. @RequestMapping(value = "/quick14")
  2. @ResponseBody
  3. public void save14(VO vo) {
  4. System.out.println(vo);
  5. }
  1. public class VO {
  2. private List<User> userList;
  3. @Override
  4. public String toString() {
  5. return "VO{" +
  6. "userList=" + userList +
  7. '}';
  8. }
  9. public void setUserList(List<User> userList) {
  10. this.userList = userList;
  11. }
  12. public List<User> getUserList() {
  13. return userList;
  14. }
  15. }

当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以
直接接收集合数据而无需使用POJO进行包装。

  1. <script>
  2. var userList = new Array();
  3. userList.push({username:"zhangsan",age:18});
  4. userList.push({username:"lisi",age:28});
  5. $.ajax({
  6. type:"POST",
  7. url:"${pageContext.request.contextPath}/user/quick15",
  8. data:JSON.stringify(userList),
  9. contentType:"application/json;charset=utf-8"
  10. });
  11. </script>

当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装

  1. @RequestMapping(value = "/quick15")
  2. @ResponseBody
  3. public void save15(@RequestBody List<User> userList) {
  4. System.out.println(userList);
  5. }

注意:通过谷歌开发者工具抓包发现,没有加载到jquery文件,原因是SpringMVC的前端控制器
DispatcherServlet的url-pattern配置的是/,代表对所有的资源都进行过滤操作,我们可以通过以下两种
方式指定放行静态资源:

  • 在spring-mvc.xml配置文件中指定放行的资源<mvc:resourcesmapping="/js/**" location="/js/"/>
  • 使用<mvc:default-servlet-handler/>标签

2.6 请求数据乱码问题

当post请求时,数据会出现乱码,我们可以设置一个过滤器来进行编码的过滤。

  1. <!--配置全局过滤的filter-->
  2. <filter>
  3. <filter-name>CharacterEncodingFilter</filter-name>
  4. <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  5. <init-param>
  6. <param-name>encoding</param-name>
  7. <param-value>UTF-8</param-value>
  8. </init-param>
  9. </filter>
  10. <filter-mapping>
  11. <filter-name>CharacterEncodingFilter</filter-name>
  12. <url-pattern>/*</url-pattern>
  13. </filter-mapping>

2.7 参数绑定注解@requestParam

当请求的参数名称与Controller的业务方法参数名称不一致时,就需要通过@RequestParam注解显示的绑定

  1. <form action="${pageContext.request.contextPath}/quick14" method="post">
  2. <input type="text" name="name"><br>
  3. <input type="submit" value="提交"><br>
  4. </form>
  1. @RequestMapping(value = "/quick16")
  2. @ResponseBody // .../user/quick16?name=%E5%BC%A0%E4%B8%89
  3. public void save16(@RequestParam(value = "name", required = false, defaultValue = "it你好") String username) {
  4. System.out.println(username);
  5. }

注解@RequestParam还有如下参数可以使用:

  • value:与请求参数名称
  • required:此在指定的请求参数是否必须包括,默认是true,提交时如果没有此参数则报错
  • defaultValue:当没有指定请求参数时,则使用指定的默认值赋值

2.8 获得Restful风格的参数

Restful是一种软件架构风格、设计风格,而不是标准,只是提供了一组设计原则和约束条件。主要用于客户端和服务器交互类的软件,基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存机制等。
Restful风格的请求是使用“url+请求方式”表示一次请求目的的,HTTP 协议里面四个表示操作方式的动词如下:

  • GET:用于获取资源
  • POST:用于新建资源
  • PUT:用于更新资源
  • DELETE:用于删除资源

上述url地址/user/1中的1就是要获得的请求参数,在SpringMVC中可以使用占位符进行参数绑定。地址/user/1可以写成/user/{id},占位符{id}对应的就是1的值。在业务方法中我们可以使用@PathVariable注解进行占位符的匹配获取工作。

  1. // http://localhost:8080/itheima_spring_mvc_war_exploded/user/quick17/jhkjkh
  2. @RequestMapping(value = "/quick17/{name}")
  3. @ResponseBody
  4. public void save17(@PathVariable(value = "name", required = true) String name) {
  5. System.out.println(name);
  6. }

2.9 自定义类型转换器

  • SpringMVC 默认已经提供了一些常用的类型转换器,例如客户端提交的字符串转换成int型进行参数设置。
  • 但是不是所有的数据类型都提供了转换器,没有提供的就需要自定义转换器,例如:日期类型的数据就需要自定义转换器。
    自定义类型转换器的开发步骤:
    ① 定义转换器类实现Converter接口
    ② 在配置文件中声明转换器
    ③ 在<annotation-driven>中引用转换器

① 定义转换器类实现Converter接口

  1. public class DateConverter implements Converter<String, Date> {
  2. @Override
  3. public Date convert(String dataStr) {
  4. // 将日期字符转换成日期对象 返回
  5. SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
  6. Date date = null;
  7. try {
  8. date = format.parse(dataStr);
  9. } catch (ParseException e) {
  10. e.printStackTrace();
  11. }
  12. return date;
  13. }
  14. }

② 在配置文件中声明转换器

  1. <!--声明转换器 日期转换-->
  2. <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
  3. <property name="converters">
  4. <list>
  5. <bean class="com.itheima.converter.DateConverter"></bean>
  6. </list>
  7. </property>
  8. </bean>

③ 在<annotation-driven>中引用转换器

  1. <mvc:annotation-driven conversion-service="converterService"/>

2.10 获得Servlet相关API

SpringMVC支持使用原始ServletAPI对象作为控制器方法的参数进行注入,常用的对象如下:

  • HttpServletRequest
  • HttpServletResponse
  • HttpSession
  1. @RequestMapping(value="/quick19")
  2. @ResponseBody
  3. public void save19(HttpServletRequest request, HttpServletResponse response, HttpSession session) throws IOException {
  4. System.out.println(request);
  5. System.out.println(response);
  6. System.out.println(session);
  7. }

2.11 获得请求头

1. @RequestHeader

使用@RequestHeader可以获得请求头信息,相当于web阶段学习的request.getHeader(name)
@RequestHeader注解的属性如下:

  • value:请求头的名称
  • required:是否必须携带此请求头
  1. @RequestMapping(value="/quick20")
  2. @ResponseBody
  3. public void save20(@RequestHeader(value = "User-Agent") String user_agent) throws IOException {
  4. System.out.println(user_agent);
  5. }

2.@CookieValue

使用@CookieValue可以获得指定Cookie的值
@CookieValue注解的属性如下:

  • value:指定cookie的名称
  • required:是否必须携带此cookie
  1. @RequestMapping(value="/quick21")
  2. @ResponseBody
  3. public void save21(@CookieValue(value = "JSESSIONID") String jsessionid) throws IOException {
  4. System.out.println(jsessionid);
  5. }

2.12 文件上传

1. 文件上传客户端三要素

  • 表单项type=“file”
  • 表单的提交方式是post
  • 表单的enctype属性是多部分表单形式,及enctype=“multipart/form-data”

04_MVC的请求和响应 - 图2

2. 文件上传原理

  • 当form表单修改为多部分表单时,request.getParameter()将失效。
  • enctype=“application/x-www-form-urlencoded”时,form表单的正文内容格式是: key=value&key=value&key=value
  • 当form表单的enctype取值为Mutilpart/form-data时,请求正文内容就变成多部分形式:

04_MVC的请求和响应 - 图3

2.13 单文件上传步骤

① 导入fileupload和io坐标
② 配置文件上传解析器
③ 编写文件上传代码

2.14 单文件上传实现

① 导入fileupload和io坐标

  1. <!--文件上传-->
  2. <dependency>
  3. <groupId>commons-fileupload</groupId>
  4. <artifactId>commons-fileupload</artifactId>
  5. <version>1.3.1</version>
  6. </dependency>
  7. <dependency>
  8. <groupId>commons-io</groupId>
  9. <artifactId>commons-io</artifactId>
  10. <version>2.3</version>
  11. </dependency>
  12. </dependencies>

② 配置文件上传解析器

  1. <!--配置文件上传解析器 名称不能写错-->
  2. <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
  3. <!--上传文件总大小-->
  4. <property name="maxUploadSize" value="5242800"/>
  5. <!--上传单个文件的大小-->
  6. <property name="maxUploadSizePerFile" value="5242800"/>
  7. <!--上传文件的编码类型-->
  8. <property name="defaultEncoding" value="UTF-8"/>
  9. </bean>

③ 编写文件上传代码

  1. <form action="${pageContext.request.contextPath}/user/quick22" method="post" enctype="multipart/form-data">
  2. 名称<input type="text" name="username"><br/>
  3. 文件1<input type="file" name="uploadFile"><br/>
  4. 文件2<input type="file" name="uploadFile2"><br/>
  5. <input type="submit" value="提交">
  6. </form>
  1. @RequestMapping(value="/quick22")
  2. @ResponseBody
  3. public void save22(String username, MultipartFile uploadFile,MultipartFile uploadFile2) throws IOException {
  4. System.out.println(username);
  5. // System.out.println(uploadFile);
  6. // 获得上传文件的名称
  7. String originalFilename = uploadFile.getOriginalFilename();
  8. uploadFile.transferTo(new File("C:\\lol\\" + originalFilename));
  9. String originalFilename2 = uploadFile2.getOriginalFilename();
  10. uploadFile.transferTo(new File("C:\\lol\\" + originalFilename2));
  11. }

2.15 多文件上传实现

多文件上传,只需要将页面修改为多个文件上传项,将方法参数MultipartFile类型修改为MultipartFile[]即可

  1. <form action="${pageContext.request.contextPath}/user/quick23" method="post" enctype="multipart/form-data">
  2. 名称<input type="text" name="username"><br/>
  3. 文件1<input type="file" name="uploadFile"><br/>
  4. 文件2<input type="file" name="uploadFile"><br/>
  5. 文件2<input type="file" name="uploadFile"><br/>
  6. <input type="submit" value="提交">
  7. </form>
  1. @RequestMapping(value="/quick23")
  2. @ResponseBody
  3. public void save23(String username, MultipartFile[] uploadFile) throws IOException {
  4. System.out.println(username);
  5. for (MultipartFile multipartFile : uploadFile) {
  6. String originalFilename = multipartFile.getOriginalFilename();
  7. multipartFile.transferTo(new File("C:\\lol\\" + originalFilename));
  8. }
  9. }