5.Spring MVC获得请求数据

5.Spring MVC获得请求数据

5.1 获得请求参数

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

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

5.2 获得基本类型参数

Controller中的业务方法的参数名称要与请求参数的name一致，参数值会自动映射匹配。
http://localhost:8080/Spring_mvc/quick11?username=zhangsan&age=12
启动服务，在浏览器地址栏输入上面地址，则在下列方法中会接收到username和age的参数值

  /**
     * 获得简单类型参数
     * @param username
     * @param age
     */
    @RequestMapping("/quick11")
    @ResponseBody //告知SpringMVC框架该方法不进行视图跳转，直接进行数据响应
    public void save11(String username,int age){
        System.out.println(username);
        System.out.println(age);
    }

5.3 获得POJO类型参数

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

http://localhost:8080/Spring_mvc/quick12?username=zhangsan&age=12

POJO

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

Controller

/**
 * 获得POJO类型参数
 * Controller中业务方法的POJO参数的属性与请求参数的name一致，参数值会被自动映射
 */
@RequestMapping("/quick12")
@ResponseBody //告知SpringMVC框架该方法不进行视图跳转，直接进行数据响应
public void save12(User user){
    
    System.out.println(user);
}

5.4 获得数组类型参数

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

/**
 * 获得数组类型参数
 * Controller中业务方法的数组名称与请求参数的name一致，参数值会被自动映射
 * http://localhost:8080/Spring_mvc/quick13?strs=111&strs=222&strs=333
 */
@RequestMapping("quick13")
@ResponseBody
public void save13(String[] strs){
    
    System.out.println(Arrays.asList(strs));
}

5.5 获得集合类型参数

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

编写页面表单

<form action="${pageContext.request.contextPath}/quick14" method="post">
    <%--第一个对象--%>
    <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="submit" value="提交">
</form>

Controller层

/**
 * 获得集合类型参数
 * 获得集合参数时，要将集合参数包装到一个POJO中才可以
 * 此处当传递的参数是一个User类型的集合时，与VO类的属性一致，参数值会被自动映射
 */
@RequestMapping("/quick14")
@ResponseBody
public void save14(VO vo){
    
    System.out.println(vo);
}

在COntroler层接收到的集合类型参数，需要封装到一个POJO中，才能接收得到
封装的POJO

public class VO {

    //将集合作为属性，封装到POJO里面
    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 +
                '}';
    }
}

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

   <script>
        var userList = new Array();
        userList.push({username:"zhangsan",age:19});
        userList.push({username:"lisi",age:20});

        $.ajax({
            type:"post",
            url:"${pageContext.request.contextPath}/quick15",
            data:JSON.stringify(userList),
            contentType:"application/json;charset=utf-8"
        });
    </script>

 /**
     * 获得集合类型参数
     * 当使用ajax提交时，可以指定contentType为json形式，那么再方法参数位置使用@RequestBody可以
     * 直接接收集合数据而无需使用pojo进行包装
     */
    @RequestMapping("/quick15")
    @ResponseBody
    public void save15(@RequestBody List<User> userList){
        System.out.println(userList);
        System.out.println("quick15");
    }

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

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

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

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

5.7 参数绑定注解@requestParam

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

<form action="${pageContext.request.contextPath}/quick16" method="post">
    姓名：<input type="text" name="name"><br>
    <input type="submit" value="提交">
</form>

 /**
     * 当请求的参数名称与Controller的业务方法参数名称不一致时，
     * 就需要通过@RequestParam注解显示的绑定。
     * @param username
     */
    @RequestMapping("/quick16")
    @ResponseBody
    public void save16(@RequestParam("name") String username){
        System.out.println(username);
    }

注解@RequestParam还有如下参数可以使用：
 value：与请求参数名称
 required：此在指定的请求参数是否必须包括，默认是true，提交时如果没有此参数则报错
 defaultValue：当没有指定请求参数时，则使用指定的默认值赋值

  /**
     * 可以配置不用必须传递参数
     * 和设置默认值，如果没有传递参数，则使用默认值
     * @param username
     */
    @RequestMapping("/quick17")
    @ResponseBody
    public void save17(@RequestParam(value = "name",required = false,defaultValue = "李四") String username){
        System.out.println(username);
    }

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

/**
 * 在SpringMVC中可以使用占位符进行参数绑定。地址/user/1可以写成
 * /user/{id}，占位符{id}对应的就是1的值。在业务方法中我们可以使
 * 用@PathVariable注解进行占位符的匹配获取工作。
 * @param username
 */
@RequestMapping("/quick18/{name}")
@ResponseBody
public void save18(@PathVariable(value = "name",required = true) String username){
    System.out.println(username);
}

5.9 自定义类型转换器

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

自定义类型转换器的开发步骤：
① 定义转换器类实现Converter接口

  public class DateConverter  implements Coverter<String, Date>{
        @Override
        public Date convert(String source) {
            SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
            try {
                Date date = format.parse(source);
                return date;
            } catch (ParseException e) {
                e.printStackTrace();
            }
            return null; }
    }

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

  <bean id="converterService" 
    class="org.springframework.context.support.ConversionServiceFactoryBean"> <property name="converters"> <list><bean class="com.itheima.converter.DateConverter"/>
    </list>
    </property>
    </bean>

③ 在中引用转换器

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

5.10 获得Servlet相关API

SpringMVC支持使用原始ServletAPI对象作为控制器方法的参数进行注入，常用的对象如下：
 HttpServletRequest
 HttpServletResponse
 HttpSession

/**
 * SpringMVC支持使用原始ServletAPI对象作为控制器方法的参数进行注入，
 * @param httpRequest
 * @param httpResponse
 * @param httpSession
 */
@RequestMapping("/quick19")
@ResponseBody
public void save19(HttpRequest httpRequest, HttpResponse httpResponse, HttpSession httpSession){
    System.out.println(httpRequest);
    System.out.println(httpResponse);
    System.out.println(httpSession);
}
 

5.11 获得请求头

1.@RequestHeader
使用@RequestHeader可以获得请求头信息，相当于web阶段学习的request.getHeader(name)
@RequestHeader注解的属性如下：
 value：请求头的名称
 required：是否必须携带此请求头

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

2.@CookieValue
使用@CookieValue可以获得指定Cookie的值
@CookieValue注解的属性如下：
 value：指定cookie的名称
 required：是否必须携带此cookie

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

5.12 文件上传

1. 文件上传客户端三要素
    表单项type=“file”
    表单的提交方式是post
    表单的enctype属性是多部分表单形式，及enctype=“multipart/form-data”

名称:
文件:

2. 文件上传原理
    当form表单修改为多部分表单时，request.getParameter()将失效。
    enctype=“application/x-www-form-urlencoded”时，form表单的正文内容格式是：
   key=value&key=value&key=value
    当form表单的enctype取值为Mutilpart/form-data时，请求正文内容就变成多部分形式：
   [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-WVIeSVk0-1634008426770)(…/Spring_mvc/img/文件上传原理.png)]

5.13 单文件上传步骤

① 导入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.6</version>
        </dependency>

② 配置文件上传解析器

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

③ 编写文件上传代码

    /**
     * 接收单文件上传文件
     */
    @RequestMapping("/quick22")
    @ResponseBody
    public void save22(String name, MultipartFile uploadFile) throws IOException {
        //获得文件名称
        String originalFilename = uploadFile.getOriginalFilename();
        
        //保存文件
        uploadFile.transferTo(new File("c:\\upload\\"+originalFilename));
    }

5.15 多文件上传实现

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

    <%--多文件上传--%>
    <form action="${pageContext.request.contextPath}/quick23" method="post" enctype="multipart/form-data">
        名称:<input type="text" name="username"><br>
        文件1:<input type="file" name="upload"><br>
        文件2:<input type="file" name="upload"><br>
        文件3:<input type="file" name="upload"><br>
        文件4:<input type="file" name="upload"><br>
        <input type="submit" value="提交">
    </form>

 /**
         * 接收多文件上传文件
         */
        @RequestMapping("/quick23")
        @ResponseBody
        public void save23(String username, MultipartFile[] upload) throws IOException {
            for (MultipartFile file : upload) {
                String filename = file.getOriginalFilename();
                System.out.println(filename);
            } 
        }

5.16 知识要点

MVC实现数据请求方式
 基本类型参数
 POJO类型参数
 数组类型参数
 集合类型参数

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