Spring学习笔记-第九天：SpringMVC的请求：获得基本类型/POJO类型/数组类型/集合类型参数，参数绑定注解，Restful风格的参数，自定义类型转换器，相关API和请求头；文件上传：单文件和多文件上传

五、SpringMVC的请求

1.获得请求参数

1.大纲

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

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

2.获得基本类型参数

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

http://localhost:8080/itheima_springmvc1/quick9?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);
    }

3.获得POJO类型参数

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

1. 创建实体类，设置好set&get方法
2. Controller直接调用

    @RequestMapping(value = "/quick12")
    @ResponseBody//还带着这个，代表不进行页面跳转
    public void save12(User user) throws IOException {//意味着响应体是空的
        System.out.println(user);
    }

4.获得数组类型参数

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

http://localhost:8080/user/quick13?strs=aaa&strs=bbb&strs=ccc

    @RequestMapping(value = "/quick13")
    @ResponseBody//还带着这个，代表不进行页面跳转
    public void save13(String[] strs) throws IOException {//意味着响应体是空的
        System.out.println(Arrays.asList(strs));
    }

5.获得集合类型参数

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

1. 创建一个实体（VO-valueObject）设置get&set方法

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. 用VO对象代替原来的List-List userList
3. 前端进行输入，注意输入格式

    <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="text" name="userList[2].username"><br/>
        <input type="text" name="userList[2].age"><br/>
    </form>

    @RequestMapping(value = "/quick14")
    @ResponseBody//还带着这个，代表不进行页面跳转
    public void save14(VO vo) throws IOException {//意味着响应体是空的

        System.out.println(vo);
    }

4. 测试

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

1. 通过js设置List数据和转换成json格式并提交

    <script src="${pageContext.request.contextPath}/js/jquery-3.3.1.js"></script>
    <script>
        var userList = new Array();
        userList.push({username:"zhanghai",age:"18"});
        userList.push({username:"zhangli",age:"20"});
        userList.push({username:"limei",age:"18"});
        $.ajax({
            //请求方式
            type:"POST",
            //请求地址
            url:"${pageContext.request.contextPath}/user/quick15",
            //把userList转换成JSON格式
            data:JSON.stringify(userList),
            //指定编码
            contentType:"application/json;charset=utf-8"
        });
    </script>

2. 设置Controller,服务端可以直接接收到list，需要在参数中设置注解

    @RequestMapping(value = "/quick15")
    @ResponseBody//还带着这个，代表不进行页面跳转
    public void save15(@RequestBody List<User> userList) throws IOException {//意味着响应体是空的
        System.out.println(userList);
    }

3. 开始测试，此时发现出现了错误，jquery文件找不到，这是由于静态资源的访问权限问题，可以在spring-mvc配置文件中配置解决

<mvc:resources mapping="/js/**" location="/js/"/>
这是由于前端控制器的配置导致的，这句话是开放资源的访问权限，同理可以开放类似图片库的访问权限
前一个位置是访问时查找的地址，后一个位置是实际目录

除了这种写法，还可以使用别的方法设置

<mvc:default-servlet-handler/>
表示若找不到资源，就交由tomcat进行查找

6.请求数据乱码问题

当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>

7.参数绑定注解@requestParam

当请求的参数名称与Controller的业务方法参数名称不一致时，就需要通过@requestParam注解进行绑定

    @RequestMapping(value = "/quick16")
    @ResponseBody//还带着这个，代表不进行页面跳转
    public void save16(@RequestParam(value = "name") String username) throws IOException {//意味着响应体是空的
        System.out.println(username);
    }

将请求的参数名称是name的进行转换

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

• value：与请求参数名称匹配的
• required：默认是true，代表指定的请求是否必须包括这个参数即如果设置成false，则不必要需要该参数，无参数提交不会报错
• defaultValue：当没有请求参数时的默认值赋值

8.获得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/user/quick17/zhangsan

首先设置好@RequestMapping中的value来获取url中的参数
然后设置String name接收数据，但在这之前需要对地址进行解析，通过@PathVariable对函数的name进行赋值

PathVariable中的value必须和RequestMapping中的占位符名称进行匹配，String定义的名称随意

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

可以在RequestMapping中method中设定各个行为的区分，可见之前笔记。

9.自定义类型转换器

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

开发步骤：

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

   public class DateConverter implements Converter<String, Date> {
       public Date convert(String dateStr) {
           //将日期的字符串转换成真正的日期对象，进行返回
           SimpleDateFormat format=new SimpleDateFormat("yyyy-MM-dd");
           Date parse = null;
           try {
               parse = format.parse(dateStr);
           } catch (ParseException e) {
               e.printStackTrace();
           }
           return parse;
       }
   }
   
   

2. 在springmvc配置文件中 声明转换器

   <!--    声明转换器-->
   <!--    在工厂内部进行转换器的设置-->
   <bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
   <!--        设置转换器-->
       <property name="converters">
           <list>
               <bean  class="com.itheima.converter.DateConverter"></bean>
           </list>
       </property>
   </bean>
   
   

   在list下可以配置多个转换器。

3. 在中引用转换器

<mvc:annotation-driven conversion-service="conversionService"/>

10.获得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);
    }

11.获得请求头

1.@RequestHeader

使用@RequestHeader可以获得请求头信息，相当于request.getHeader(name)。该注解属性如下

• 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);
    }

2.@CookieValue

使用@CookieValue可以获得指定Cookie的值

• value：指定cookie的名称
• required：是否必须携带此cookie

    @RequestMapping(value = "/quick21")
    @ResponseBody//还带着这个，代表不进行页面跳转
    public void save21(@CookieValue(value = "JSESSIONID",required = false) String jsessionId) throws IOException {//意味着响应体是空的
        System.out.println(jsessionId);
    }

2.文件上传

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

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

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

2.文件上传原理

• 当form表单修改为多部分表单时。request.getxxx()方法都会失效，因为原本是url编码方式的表单提交
• 当enctype="application/x-www-form-urlencoded" 时，form表单的正文内容格式是key=value&key=value...
• 当设置为enctype="multipart/form-data"时，请求正文内容就变成多部分形式

3.单文件上传步骤

1. 导入fileupload和io坐标

        <dependency>
            <groupId>commons-fileupload</groupId>
            <artifactId>commons-fileupload</artifactId>
            <version>1.3.3</version>
        </dependency>
        <dependency>
            <groupId>commons-io</groupId>
            <artifactId>commons-io</artifactId>
            <version>2.6</version>
        </dependency>

2. 配置文件上传解析器

<!--    配置文件上传解析器-->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--        配置默认编码-->
        <property name="defaultEncoding" value="UTF-8"/>
<!--        上传文件总大小-->
        <property name="maxUploadSize" value="500000"/>
    </bean>

3. 编写文件上传代码

4.多文件上传实现

配置过程和上面的类似，若几个文件名称一样，服务端也可以用数组接。

<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>

@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("C:\\upload\\"+originalFilename));
        }
    }