SpringMVC数据处理

数据响应

页面跳转

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

   @RequestMapping("/quick")
   public String quickMethod(){
      return "index";
   }
   
   <property name="prefix" value="/WEB-INF/views/" />
   <property name=“suffix” value=".jsp" />
   
   上面会返回转发资源地址：/WEB-INF/views/index.jsp
   
   

2. 通过ModelAndView对象返回

   @RequestMapping(value="/quick5")
   public String save5(HttpServletRequest request){
    request.setAttribute("username","谢谢谢");
    return "success";
   }
   
   @RequestMapping(value="/quick4")
   public String save4(Model model){
    model.addAttribute("username","谢谢");
    return "success";
   }
   
   @RequestMapping(value="/quick3")
   public ModelAndView save3(ModelAndView modelAndView){
    modelAndView.addObject("username","小谢");
    modelAndView.setViewName("success");
    return modelAndView;
   }
   
   
   @RequestMapping(value="/quick2")
   public ModelAndView save2(){
    /*
        Model:模型 作用封装数据
        View：视图 作用展示数据
     */
    ModelAndView modelAndView = new ModelAndView();
    //设置模型数据
    modelAndView.addObject("username","谢");
    //设置视图名称
    modelAndView.setViewName("success");
   
    return modelAndView;
   }
   

回写数据

直接返回字符串

Web基础阶段，客户端访问服务器端，如果想直接回写字符串作为响应体返回的话，只需要使用response.getWriter().print("hello world") 即可，那么在Controller中想直接回写字符串该怎样呢？

1. 通过SpringMVC框架注入的response对象，使用response.getWriter().print("hello world") 回写数据，此时不需要视图跳转，业务方法返回值为void。

   @RequestMapping(value="/quick6")
   public void save6(HttpServletResponse response) throws IOException {
     response.getWriter().print("hello xie");
   }
   

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

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

知道了如何返回字符串，下面是返回json字符串：

1. 直接拼json字符串返回

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

2. 通过第三方库使用，不过先导入包，在pom中添加：

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

   然后使用该包来把对象转换为字符串：

   @RequestMapping(value="/quick9")
   @ResponseBody
   public String save9() throws IOException {
     User user = new User();
     user.setUsername("lisi");
     user.setAge(30);
     //使用json的转换工具将对象转换成json格式字符串在返回
     ObjectMapper objectMapper = new ObjectMapper();
     String json = objectMapper.writeValueAsString(user);
   
     return json;
   }
   

返回对象或集合

现在希望通过控制器直接返回对象，Spring自动转换json字符串，需要在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>

@RequestMapping(value="/quick10")
@ResponseBody
//期望SpringMVC自动将User转换成json格式的字符串
public User save10() throws IOException {
   User user = new User();
   user.setUsername("lisi2");
   user.setAge(32);

   return user;
}

这样直接返回对象会转换为json字符串。通过上面发现配置xml比较麻烦，我们可以使用MVC的注解驱动代替上述配置，在上面的配置文件中添加如下也可以实现上面的xml配置的效果。

<beans xmlns:mvc="http://www.springframework.org/schema/mvc" 
        xsi:schemaLocation="http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">
    <mvc:annotation-driven/>
</beans>

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

处理请求

获得请求参数

服务器端要获得客户端请求的参数，还需要进行数据的封装，SpringMVC可以接收如下类型的参数：

1. 基本类型参数
2. POJO类型参数
3. 数组类型参数
4. 集合类型参数

基本类型参数

Controller中的业务方法的参数名称要与请求参数的name一致，参数值会自动映射匹配。

@RequestMapping(value="/quick11")
@ResponseBody
public void save11(String username,int age) throws IOException {
   System.out.println(username);
   System.out.println(age);
}

可通过测试quick11 (opens new window)进行测试访问。

获取POJO类型参数

Controller中的业务方法的POJO参数的属性名与请求参数的name一致，参数值会自动映射匹配。

@RequestMapping(value="/quick12")
@ResponseBody
public void save12(User user) throws IOException {
   System.out.println(user);
}

可通过测试quick12 (opens new window)进行测试访问。

数组类型参数

Controller中的业务方法数组名称与请求参数的name一致，参数值会自动映射匹配。

@RequestMapping(value="/quick13")
@ResponseBody
public void save13(String[] ball) throws IOException {
   System.out.println(Arrays.asList(strs));
}

可通过测试quick13 (opens new window)进行测试访问。

集合类型参数

获得集合参数时，要将集合参数包装到一个POJO中才可以。

1. 先创建一个POJO对象VO，VO.java内容为：

   package com.muyun.domain;
   
   import java.util.List;
   
   public class VO {
       private List<User> userList;
   
       public List<User> getUserList() {
           return userList;
       }
   
       public void setUserList(List<User> userList) {
           this.userList = userList;
       }
   
       @Override
       public String toString() {
           return "VO{" +
                   "userList=" + userList +
                   '}';
       }
   }
   

2. 创建接收接口：

   @RequestMapping(value="/quick14")
   @ResponseBody
   public void save14(VO vo) throws IOException {
      System.out.println(vo);
   }
   

3. 创建测试接口，form.jsp：

   <%@ page contentType="text/html;charset=UTF-8" language="java" %>
   <html>
   <head>
       <title>Title</title>
   </head>
   <body>
   <form action="${pageContext.request.contextPath}/user/quick14" method="post">
       <%--表明是第几个User对象的username，age--%>
       <input type="text" name="userList[0].username" value="xie"><br/>
       <input type="text" name="userList[0].age" value="18"><br/>
       <input type="text" name="userList[1].username" value="li"><br/>
       <input type="text" name="userList[1].age" value="22"><br/>
       <input type="submit" value="测试quick14接口">
   </form>
   
   </body>
   </html>
   

4. 上面表单如果有中文的话，会出现乱码，这个时候就需要在WEB-INF中的web.xml配置：

   <!--配置全局过滤的filter-->
   <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>
   

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

1. 创建接收接口：

   @RequestMapping(value="/quick15")
   @ResponseBody
   public void save15(@RequestBody List<User> userList) throws IOException {
      System.out.println(userList);
   }
   

2. 创建测试接口：

   <%@ page contentType="text/html;charset=UTF-8" language="java" %>
   <html>
   <head>
       <title>Title</title>
       <script src="${pageContext.request.contextPath}/js/jquery-3.5.1.js"></script>
       <script>
           var userList = new Array();
           userList.push({username: "zhangsan", age: 18});
           userList.push({username: "lisi", age: 28});
   
           $.ajax({
               type: "POST",
               url: "${pageContext.request.contextPath}/user/quick15",
               data: JSON.stringify(userList),
               contentType: "application/json;charset=utf-8"
           });
       </script>
   </head>
   <body>
   
   </body>
   </html>
   

3. 上面运行会发现无法加载jquery，这是因为SpringMVC的前端控制器DispatcherServlet的url-pattern配置的是/，代表对所有的资源都进行过滤操作，我们可以用下两种方式指定放行静态资源，均为在spring-mvc.xml中配置：

   1. <mvc:resources mapping="/js/**" location="/js/"/>
   2. mvc:default-servlet-handler/

参数绑定

当请求的参数名称与Controller的业务方法参数名称不一致时，就需要通过参数绑定注解@RequestParam显式地绑定。该注解有如下参数：

• value：设置请求参数中的名称。
• defaultValue：当没有指定请求参数时，则使用指定的默认值赋值。
• required：此在指定的请求参数是否必须包括，默认是true，提交时如果没有此参数，且没有设置defaultValue时报错。

@RequestMapping(value="/quick16")
@ResponseBody
public void save16(@RequestParam(value="name",required = false,defaultValue = "xie") String username) throws IOException {
   System.out.println(username);
}

可通过测试quick16 (opens new window)进行测试访问。

获取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注解进行占位符的匹配获取工作。

@RequestMapping(value="/quick17/{name}")
@ResponseBody
public void save17(@PathVariable(value="name") String username) throws IOException {
    System.out.println(username);
}

可通过测试quick17 (opens new window)进行测试访问。

自定义类型转换器

SpringMVC 默认已经提供了一些常用的类型转换器，例如客户端提交的字符串转换成int型进行参数设置。但是不是所有的数据类型都提供了转换器，没有提供的就需要自定义转换器，例如：日期类型的数据就需要自定义转换器。看如下接口：

@RequestMapping(value="/quick18")
@ResponseBody
public void save18(Date date) throws IOException {
    System.out.println(date);
}

通过测试quick18 (opens new window)可进行访问。但是如果换一种形式就是不行了，比如测试quick18 (opens new window)会报错，这个时候就需要自定义转换器。

自定义类型转换器的开发步骤：

1. 定义转换器类实现Converter接口

   package com.muyun.converter;
   
   import org.springframework.core.convert.converter.Converter;
   
   import java.text.ParseException;
   import java.text.SimpleDateFormat;
   import java.util.Date;
   
   public class DateConverter implements Converter<String, Date> {
       public Date convert(String dateStr) {
           //将日期字符串转换成日期对象 返回
           SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
           Date date = null;
           try {
               date = format.parse(dateStr);
           } catch (ParseException e) {
               e.printStackTrace();
           }
           return date;
       }
   }
   

2. 在配置文件中声明并引用转换器

   <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
     <property name="converters">
         <list>
             <bean class="com.muyun.converter.DateConverter"></bean>
         </list>
     </property>
   </bean>
   
   <mvc:annotation-driven conversion-service="conversionService"/>
   

获取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可以获得请求头信息，相当于web阶段学习的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);
}

文件上传

文件上传客户端

在网页端需要三个条件：

1. 表单项type="file"
2. 表单的提交方式是post
3. 表单的enctype属性是多部分表单形式，及enctype="multipart/form-data"

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>

    <form action="${pageContext.request.contextPath}/user/quick23" method="post" enctype="multipart/form-data">
        名称<input type="text" name="username"><br/>
        文件1<input type="file" name="uploadFile"><br/>
        文件2<input type="file" name="uploadFile"><br/>
        <input type="submit" value="提交">
    </form>

    <form action="${pageContext.request.contextPath}/user/quick22" method="post" enctype="multipart/form-data">
        名称<input type="text" name="username"><br/>
        文件1<input type="file" name="uploadFile"><br/>
        文件2<input type="file" name="uploadFile2"><br/>
        <input type="submit" value="提交">
    </form>
</body>
</html>

服务器端处理

当form表单修改为多部分表单时，request.getParameter()等API将失效。

• 当enctype为"application/x-www-form-urlencoded"时，form表单的正文内容格式是：key=value&key=value&key=value。
• 当enctype为"Mutilpart/form-data"时，请求正文内容就变成多部分形式。

文件上传处理

1. 导入fileupload和io坐标

   <dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>1.4</version>
   </dependency>
   <dependency>
      <groupId>commons-io</groupId>
      <artifactId>commons-io</artifactId>
      <version>2.8.0</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="500000"/>
   </bean>
   

3. 编写文件上传代码

   @RequestMapping(value="/quick23")
   @ResponseBody
   public void save23(String username, MultipartFile[] uploadFile) throws IOException {
     System.out.println(username);
     for (MultipartFile multipartFile : uploadFile) {
         String originalFilename = multipartFile.getOriginalFilename();
         multipartFile.transferTo(new File("D:\\upload\\"+originalFilename));
     }
   }
   
   @RequestMapping(value="/quick22")
   @ResponseBody
   public void save22(String username, MultipartFile uploadFile,MultipartFile uploadFile2) throws IOException {
     System.out.println(username);
     //获得上传文件的名称
     String originalFilename = uploadFile.getOriginalFilename();
     uploadFile.transferTo(new File("D:\\upload\\"+originalFilename));
     String originalFilename2 = uploadFile2.getOriginalFilename();
     uploadFile2.transferTo(new File("D:\\upload\\"+originalFilename2));
   }
   

异常处理

系统中异常包括两类：预期异常和运行时异常(RuntimeException)，前者通过捕获异常从而获取异常信息，后者主要通过规范代码开发、测试通过手段减少运行时异常的发生。系统的 dao、 service、 controller 出现都通过 throws Exception 向上抛出，最后由 springmvc 前端控制器交由异常处理器进行异常处理，如下图：

自定义异常

自定义异常处理步骤如下：

1. 定义异常类：

   package cn.muyun.exception;
   
   /**
    * 自定义异常类
    */
   public class SysException extends Exception{
   
       // 存储提示信息的
       private String message;
   
       public String getMessage() {
           return message;
       }
   
       public void setMessage(String message) {
           this.message = message;
       }
   
       public SysException(String message) {
           this.message = message;
       }
   
   }
   

2. 创建异常处理器类实现HandlerExceptionResolver

   package cn.muyun.exception;
   
   import org.springframework.web.servlet.HandlerExceptionResolver;
   import org.springframework.web.servlet.ModelAndView;
   
   import javax.servlet.http.HttpServletRequest;
   import javax.servlet.http.HttpServletResponse;
   
   /**
    * 异常处理器
    */
   public class SysExceptionResolver implements HandlerExceptionResolver{
   
       /**
        * 处理异常业务逻辑
        * @param request
        * @param response
        * @param handler
        * @param ex
        * @return
        */
       public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
           // 获取到异常对象
           SysException e = null;
           if(ex instanceof SysException){
               e = (SysException)ex;
           }else{
               e = new SysException("系统正在维护....");
           }
           // 创建ModelAndView对象
           ModelAndView mv = new ModelAndView();
           mv.addObject("errorMsg",e.getMessage());
           mv.setViewName("error");
           return mv;
       }
   
   }
   

3. 配置异常处理器，在springmvc.xml中：

   <bean id="sysExceptionResolver" class="cn.muyun.exception.SysExceptionResolver"/>
   

4. 编写异常页面

   <%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>
   <html>
   <head>
       <title>Title</title>
   </head>
   <body>
   
       ${errorMsg}
   
   </body>
   </html>
   

5. 测试异常跳转

   package cn.muyun.controller;
   
   import cn.muyun.exception.SysException;
   import org.springframework.stereotype.Controller;
   import org.springframework.web.bind.annotation.RequestMapping;
   
   @Controller
   @RequestMapping("/user")
   public class UserController {
   
   
       @RequestMapping("/testException")
       public String testException() throws SysException{
           System.out.println("testException执行了...");
   
           try {
               // 模拟异常
               int a = 10/0;
           } catch (Exception e) {
               // 打印异常信息
               e.printStackTrace();
               // 抛出自定义异常信息
               throw new SysException("查询所有用户出现错误了...");
           }
   
           return "success";
       }
   
   }
   

拦截器

Spring MVC 的拦截器类似于 Servlet 开发中的过滤器 Filter，用于对处理器进行预处理和后处理。将拦截器按一定的顺序联结成一条链，这条链称为拦截器链（Interceptor Chain）。在访问被拦截的方法或字段时，拦截器链中的拦截器就会按其之前定义的顺序被调用。拦截器也是AOP思想的具体实现。

拦截器和过滤器区别

区别	过滤器	拦截器
使用范围	是 servlet 规范中的一部分，任何 Java Web 工程都可以使用	是 SpringMVC 框架自己的，只有使用了 SpringMVC 框架的工程才能用
拦截范围	在 url-pattern 中配置了路径之后，可以对所有要访问的资源拦截	只会拦截访问的控制器方法，如果访问的是 jsp，html,css,image 或者 js 是不会进行拦截的

拦截器快速入门

1. 创建拦截器类实现HandlerInterceptor接口

2. 配置拦截器

   <!--配置拦截器-->
   <mvc:interceptors>
     <!--配置拦截器-->
     <mvc:interceptor>
         <!--要拦截的具体的方法-->
         <mvc:mapping path="/user/*"/>
         <!--不要拦截的方法
         <mvc:exclude-mapping path=""/>
         -->
         <!--配置拦截器对象-->
         <bean class="cn.muyun.interceptor.MyInterceptor1" />
     </mvc:interceptor>
   
     <!--配置第二个拦截器-->
     <mvc:interceptor>
         <!--要拦截的具体的方法-->
         <mvc:mapping path="/**"/>
         <!--不要拦截的方法
         <mvc:exclude-mapping path=""/>
         -->
         <!--配置拦截器对象-->
         <bean class="cn.muyun.interceptor.MyInterceptor2" />
     </mvc:interceptor>
   </mvc:interceptors>
   

3. 测试拦截器的拦截效果

拦截器方法

下面是拦截器方法说明：

方法名	说明
preHandle	方法将在请求处理之前进行调用，该方法的返回值是布尔值Boolean类型的，当它返回为false时，表示请求结束，后续的Interceptor和Controller 都不会再执行；当返回值为true 时就会继续调用下一个Interceptor 的preHandle 方法
postHandle	该方法是在当前请求进行处理之后被调用，前提是preHandle方法的返回值为true时才能被调用，且它会在DispatcherServlet进行视图返回渲染之前被调用，所以我们可以在这个方法中对Controller处理之后的ModelAndView对象进行操作
afterCompletion	该方法将在整个请求结束之后，也就是在DispatcherServlet渲染了对应的视图之后执行，前提是preHandle方法的返回值为true时才能被调用