SpringMVC（二、请求和响应）

1、SpringMVC的数据响应

1.1 SpringMVC的数据响应方式

1） 页面跳转

• 直接返回字符串

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

  

  ​ 返回带有前缀的字符串：

  ​ 转发：forward:/WEB-INF/views/index.jsp

  ​ 重定向：redirect:/index.jsp

• 通过ModelAndView对象返回

     @RequestMapping(value="/quick3")
      public ModelAndView save3(ModelAndView modelAndView){
          modelAndView.addObject("username","xmp");
          modelAndView.setViewName("success");
          return modelAndView;
      }
  
  
      @RequestMapping(value="/quick2")
      public ModelAndView save2(){
          /*
              Model:模型 作用封装数据
              View：视图 作用展示数据
           */
          ModelAndView modelAndView = new ModelAndView();
          //设置模型数据
          modelAndView.addObject("username","xmp");
          //设置视图名称
          modelAndView.setViewName("success");
  
          return modelAndView;
      }
  

• 向request域存储数据

  1）通过SpringMVC框架注入的request对象setAttribute()方法设置

  // 请求地址  http://localhost:8080/user/quick
      @RequestMapping(value="/quick",method = RequestMethod.GET,params = {"username"})
      public String save(){
          System.out.println("Controller save running....");
          return "success";
      }
  

  2）通过ModelAndView的addObject()方法设置

    @RequestMapping(value="/quick3")
      public ModelAndView save3(ModelAndView modelAndView){
          modelAndView.addObject("username","xmp");
          modelAndView.setViewName("success");
          return modelAndView;
      }
  

2） 回写数据

• 直接返回字符串

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

      @RequestMapping(value="/quick4")
      public String save4(Model model){
          model.addAttribute("username","xmp");
          return "success";
      }
  

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

  @RequestMapping(value="/quick5")
  public String save5(HttpServletRequest request){
      request.setAttribute("username","xmp");
      return "success";
  }
  

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

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

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

  	<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")
      @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;
      }
  

• 返回对象或集合

  ​ 通过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>

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

        return user;
    }

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

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

​ 在 SpringMVC 的各个组件中，处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。

​ 使用自动加载RequestMappingHandlerMapping（处理映射器）和 RequestMappingHandlerAdapter（ 处 理 适 配 器 ），可用在Spring-xml.xml配置文件中使用 替代注解处理器和适配器的配置。

​ 同时使用默认底层就会集成jackson进行对象或集合的json格式字符串的转换。

小结

SpringMVC**的数据响应方式**

1） 页面跳转 

​		直接返回字符串

​		通过ModelAndView对象返回 

2） 回写数据 

​		直接返回字符串 

​		返回对象或集合

2、SpringMVC 获得请求数据

2.1 获得请求参数

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

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

1） 获得基本类型参数

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

​ http://localhost:8080/springmvc/quick9?username=zhangsan&age=19

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

2）获得POJO类型参数

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

​ http://localhost:8080/springmvc/quick9?username=zhangsan&age=19

public class User {

    private String username;
    private int age;

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    @Override
    public String toString() {
        return "User{" +
                "username='" + username + '\'' +
                ", age=" + age +
                '}';
    }
}

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

3）获得数组类型参数

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

​ http://localhost:8080/springmvc/quick9?username=zhangsan&age=19

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

4）获得集合类型参数

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

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 +
                '}';
    }
}

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

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

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
    <script src="${pageContext.request.contextPath}/js/jquery-3.3.1.js"></script>
    <script>
        var userList = new Array();
        userList.push({username:"zhangsan",age:19});
        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>

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

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

	1、在spring-mvc.xml配置文件中指定放行的资源
	<!--开放资源的访问-->
    <mvc:resources mapping="/js/**" location="/js/"/>
    <mvc:resources mapping="/img/**" location="/img/"/>
    
    2、使用标签
    <mvc:default-servlet-handler/>

5）请求数据乱码问题

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

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

6）参数绑定注解@requestParam

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

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

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

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

7）获得Restful风格的参数

​ Restful是一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。主要用于客户端和服务 器交互类的软件，基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存机制等。

​ REST（英文：Representational State Transfer，简称REST）描述了一个架构样式的网络系统，比如 web 应用程序。在目前主流的三种Web服务交互方案中，REST相比于SOAP（Simple Object Access protocol，简单对象访问协议）以及XML-RPC更加简单明了，无论是对URL的处理还是对Payload的编码，REST都倾向于用更加简单轻量的方法设计和实现。值得注意的是REST并没有一个明确的标准，而更像是一种设计的风格。

​ 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}")   //{name}
    @ResponseBody
    public void save17(@PathVariable(value="name") String username) throws IOException {
        System.out.println(username);
    }

8）自定义类型转换器

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

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

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

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

​ ③ 在中引用转换器

• 定义转换器类实现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;
    }
}

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

 <!--声明转换器-->
    <bean id="conversionService" 	
   		class="org.springframework.context.support.ConversionServiceFactoryBean">
        <property name="converters">
            <list>
                <bean class="com.xmp.converter.DateConverter"></bean>
            </list>
        </property>
    </bean>

• 在中引用转换器

    <!--mvc的注解驱动-->
    <mvc:annotation-driven conversion-service="conversionService"/>

9）获得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);
    }

10）获得请求头

• @RequestHeader

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

​ value：请求头的名称

​ required：是否必须携带此请求头

@RequestMapping("/quick17")
@ResponseBody
public void quickMethod17(@RequestHeader(value = "User-Agent",required = false) String headerValue){
	System.out.println(headerValue);
}

• @CookieValue

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

	value：指定cookie的名称

​ required：是否必须携带此cookie

@RequestMapping("/quick18")
@ResponseBody
public void quickMethod18(@CookieValue(value = "JSESSIONID",required = false) String jsessionid){
	System.out.println(jsessionid);
}

11）文件上传

• 单文件上传步骤

① 导入fileupload和io坐标

<dependency>
	<groupId>commons-fileupload</groupId>
	<artifactId>commons-fileupload</artifactId>
	<version>1.2.2</version>
</dependency>
<dependency>
	<groupId>commons-io</groupId>
	<artifactId>commons-io</artifactId>
	<version>2.4</version>
</dependency>

② 配置文件上传解析器

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
	<!--上传文件总大小-->
	<property name="maxUploadSize" value="5242800"/>
	<!--上传单个文件的大小-->
	<property name="maxUploadSizePerFile" value="5242800"/>
	<!--上传文件的编码类型-->
	<property name="defaultEncoding" value="UTF-8"/>
</bean>

③ 编写文件上传代码

@RequestMapping("/quick20")
@ResponseBody
public void quickMethod20(String name,MultipartFile uploadFile) throws IOException {
	//获得文件名称
	String originalFilename = uploadFile.getOriginalFilename();
	//保存文件
	uploadFile.transferTo(new File("C:\\upload\\"+originalFilename));
}

• 多文件上传实现

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

<h1>多文件上传测试</h1>
<form action="${pageContext.request.contextPath}/quick21" method="post" enctype="multipart/form-data">
	名称：<input type="text" name="name"><br>
	文件1：<input type="file" name="uploadFiles"><br>
	文件2：<input type="file" name="uploadFiles"><br>
	文件3：<input type="file" name="uploadFiles"><br>
	<input type="submit" value="提交"><br>
</form>

@RequestMapping("/quick21")
@ResponseBody
public void quickMethod21(String name,MultipartFile[] uploadFiles) throws IOException {
	for (MultipartFile uploadFile : uploadFiles){
		String originalFilename = uploadFile.getOriginalFilename();
		uploadFile.transferTo(new File("C:\\upload\\"+originalFilename));
	}
}

小结

**MVC实现数据请求方式** 

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

**MVC获取数据细节**

 中文乱码问题 
 @RequestParam 和 @PathVariable
 自定义类型转换器 
 获得Servlet相关API 
 @RequestHeader 和 @CookieValue 
 文件上传