请求参数类型

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

1、基本类型参数

2、POJO类型参数

3、数组类型参数

4、集合类型参数

我们下面会逐个来学习

请求参数类型

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

例如http:localhost:8080/user/quick10?username=zhangsan&age=12。如果我们想获得username=zhangsan&age=12这个参数，如何获取呢，如下 在Controller中写一个带两个参数的方法

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

在浏览器输入http:localhost:8080/user/quick11?username=zhangsan&age=12，就可以看到终端获取到了zhangsan 12

获得POJO类型参数

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

例如http:localhost:8080/user/quick11?username=zhangsan&age=12。如果我们想username=zhangsan&age=12这个参数放到一个类(实体类)里，如下

public class User {
    private String username;
    private int age;
    getter/setter...
}

@RequestMapping(value="/quick11")
@ResponseBody
public void save11(User user) throws IOException {
        System.out.println(user);
}
//在浏览器输入http:localhost:8080/user/quick11?username=lisi&age=13，就可以看到终端获取到了User{username='lisi', age=13}
//注意要先去User类里面重新toString方法，不然终端输出的就是地址值
//POJO类型实质上可以理解为简单的实体类，顾名思义POJO类的作用是方便程序员使用数据库中的数据表

获得数组类型参数

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

例如http:localhost:8080/user/quick12?strs=111&strs=222&strs=333。如果我们想把111,222,333放到数组(数组名叫strs)里，怎么实现呢，如下

@RequestMapping(value="/quick12")
@ResponseBody
public void save12(String[] strs) throws IOException {
        //System.out.println(strs);
        //由于上面那行的数组直接打印会出现的是地址值，为了清晰看到打印，我们把上面那行的数组转换成list集合再打印，如下
        System.out.println(Arrays.asList(strs));
}
//在浏览器输入http:localhost:8080/user/quick12?strs=111&strs=222&strs=333，就可以看到终端获取到了[111, 222, 333]

获得集合类型参数

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

首先先新建一个VO类和一个form.jsp页面来实现表单提交，要求提交的数据是集合类型的，原因是我们要把集合封装到一个VO对象里面，这样客户 端的数据才能封装到VO对象的集合里面。然后如下

@RequestMapping(value="/quick13")
@ResponseBody
public void save13(VO vo) throws IOException {
        System.out.println(vo);
}
//在浏览器输入http:localhost:8080/form.jsp，在该地址填入相应的表单数据，就可以看到终端获
//取到了VO{userList=[User{username='Tom', age=18}, User{username='lisi', age=19}]}

获得集合类型参数2

如何把集合直接封装到方法的形参位置呢

当使用ajax提交时，可以指定contentType为json形式，那么在方法参数位置使用@RequestBody可以直接接收集合数据，而无需用上面的POJO来帮 我们进行二次封装，直接一步搞定

首先我们需要一个ajax.jsp页面、一个js目录里面放一个jQuery文件(因为ajax需要用到jquery)，最后在spring.mvc解决静态资源引用权限问题。然后如下

@RequestMapping(value="/quick14")
@ResponseBody
    public void save14(@RequestBody List<User> userList) throws IOException {//内部加一个@RequestBody注解
        System.out.println(userList);
}

x
<script src="${pageContext.request.contextPath}/js/jquery-3.3.1.js"></script>
<script>
    //准备对象
    var userList = new Array();
    userList.push({username:"李白",age:18});
    userList.push({username:"孙策",age:19});
    //发送ajax请求
    $.ajax({
        type:"POST",
        url:"${pageContext.request.contextPath}/user/quick14",
        //把userList对象转换成json格式的数据
        data:JSON.stringify(userList),
        contentType:"application/json;charset=utf-8"
    })
</script>

<!--解决: 在spring-mvc里面引入静态资源(jquery-3.3.1.js)文件的权限问题-->
<mvc:resources mapping="/js/**" location="/js/"/>

静态资源访问的开启

为什么上面会找不到jquery文件的位置，原因: 由于前端控制器的配置，SpringMVC的前端控制器是一个DispatcherServlet，我们在一开始的web.xml中 就已经配置过前端控制器，其中的url-pattern标签表示缺省的Servlet，会去DispatcherServlet进行虚拟路径匹配，匹配UserController类中的 RequestMapping注解的资源，由于RequestMapping里面找不到jquery文件的资源，匹配不上就访问不了jquery文件。

解决就是在spring-mvc里面引入静态资源(jquery-3.3.1.js)文件的权限问题

xxxxxxxxxx
<mvc:resources mapping="/js/**" location="/js/"/>

代表在springMVC框架中开放对某些资源的访问权限，一般来说是静态资源

当我们后期在webapp目录下，又要新建一个img目录用来存放图片，那么我们需要在spring-mvc里面多写入如下

xxxxxxxxxx
<mvc:resources mapping="/img/**" location="/img/"/>

注意mapping是我们资源的地址，location是资源所在的目录

但是上面那种解决方法比较不方便，当静态资源增多时，需要额外写多个<mvc:resources mapping="/xxx/**" location="/xxx/"/> 我们可以使用下面那种简单的，如下

<mvc:default-servlet-handler/>

上面那行表示在访问我(服务器)的资源时，springmvc会帮忙找对应的匹配地址，找不到就交由原始容器(Tomcat)的内部机制来寻找资源

也就是这两种方式都可以让自己的静态资源被访问到

解决请求数据的乱码问题 -- 配置全局乱码过滤器

当post请求时，数据会出现乱码，我们可以设置一个过滤器来进行编码的过滤。在web.xml里面写入如下:

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

<!--验证: 访问http:localhost:8080/form.jsp-->

参数绑定的注解@requestParam -- 基本使用

当请求的名称与Controller的业务方法参数名称不一致时，就需要通过@requestParam注解，显示的去绑定新参数与原参数的关系

@RequestMapping(value="/quick15")
@ResponseBody
 public void save15(String username) throws IOException {
        System.out.println(username);
}

//在浏览器输入http:localhost:8080/user/quick15?username=张无忌，就可以看到终端获取到了张无忌
//但是，当我们业务发生变化，客户端请求的参数不是username，而是name，
//例如http:localhost:8080/user/quick15?name=小龙女，此时终端获取不到小龙女。解决:这节课的@requestParam注解就可解决，原理是映射

//我们就需要在这里(UserController类)写入如下即可实现映射*/
@RequestMapping(value="/quick16")
@ResponseBody
public void save16(@RequestParam("name") String username) throws IOException {
        System.out.println(username);
}

//验证
//http:localhost:8080/user/quick16?name=杨过
//可在终端获取,但是原先的username参数就获取不到了，例如http:localhost:8080/user/quick15?username=小龙女

参数绑定的注解@requestParam -- 详细使用

上面我们没有使用相关参数，只是简单使用一下。其实注解@requestParam有如下参数可以使用:

1、value: 与请求参数名称

2、required: 此在指定的请求参数是否必须包括，默认是true，提交时如果没有此参数报错

3、defaultValue: 当没有指定请求参数时，则使用指定的默认值赋值

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

/*
value:表示请求的参数要是'name'，例如 http:localhost:8080/user/quick16?name=杨过
    
required:false表示必须要有上面的请求参数Value，不然报错
例如http:localhost:8080/user/quick17 会报错
例如http:localhost:8080/user/quick17?name=小龙女 不报错
    
required:true表示不一定要有上面的请求参数Value，不报错
例如http:localhost:8080/user/quick17 不报错
例如http:localhost:8080/user/quick17?name=小龙女 不报错
    
defaultValue:表示如果我们没有'?name=小龙女'给出具体的值时，就会把huanf这个作为值获取在终端，简单说huanf就是默认值
例如http:localhost:8080/user/quick17，终端拿到的值是huanf
例如http:localhost:8080/user/quick17?name=小龙女，终端拿到的值是小龙女
*/

获取Restful风格的参数

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

Restful风格的请求是使用 "url+请求方式" 表示一次请求目的，HTTP协议里面四个表示操作方式的动词如下:

1、GET: 用于获取资源

2、POST: 用于新建资源

3、PUT: 用于更新资源

4、DELETE: 用于删除资源

例如:

1、/user/1 GET: 表示得到id=1的user

2、/user/1 DELETE: 表示删除id=1的user

3、/user/1 PUT: 表示更新id=1的user

4、/user POST: 表示新增user

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

@RequestMapping(value="/quick18/{myname}")
@ResponseBody
public void save18(@PathVariable(value="myname",required=true) String zidingyi) throws IOException {
        System.out.println(zidingyi);
}

//访问:http://localhost:8080/user/quick18/张三。可发现终端可以获取到张三

自定义类型转换器

SpringMVC框架内部已经定义好的一些类型转换器

1、SpringMVC默认已经提供了一些常用的类型转换器，例如客户端提交的字符串转换成int型进行参数设置

2、但是不是所有的数据类型都提供了转换器，我们可以自定义我们需要的转换器，例如:日期类型的数据就需要自定义转换器

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

1、定义转换器类，并实现Converter接口，重写方法

2、在配置文件(spring-mvc.xml)中声明转换器

3、在中引用转换器

具体过程:

第一步: 首先新建一个目录converter，在里面新建一个类DateConverter，里面写入如下:

//日期转换类。String代表转换之前的类型，Date代表要转成的格式。也就是把String类型转换成Date类型
public class DateConverter implements Converter<String, Date> {
 public Date convert(String dateStr) {
     //将字符串类型的日期，转换成date类型的日期(真正的日期对象)，最后返回
     SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
     Date date = null;
     try {
         date = format.parse(dateStr);
     } catch (ParseException e) {
         e.printStackTrace();
     }
     return date;
 }
}

第二步: 在spring-mvc.xml里面写入如下:

<bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
     <property name="converters">
         <list>
             <!--DateConverter是converter目录下的DateConverter类的路径-->
             <bean class="com.huanf.converter.DateConverter"></bean>
         </list>
     </property>
</bean>
<mvc:annotation-driven conversion-service="conversionService"/>

验证如下:

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

//访问:http://localhost:8080/user/quick19?date=2023/2/15。可发现终端获取的是Wed Feb 15 00:00:00 CST 2023
//访问:http://localhost:8080/user/quick19?date=2023-2-15。可发现直接就是网页报错了。原因日期格式不匹配

//解决:自定义日期转换器

//首先新建一个目录converter，在里面新建一个类DateConverter，在spring-mvc.xml里面声明自定义日期转换器
//然后再访问http://localhost:8080/user/quick19?date=2023-2-15就不会报错
//但是，访问http://localhost:8080/user/quick19?date=2023/2/15又报错了
//可以自己去DateConverter类改代码，一次只能支持一个日期格式类型

获得Servlet相关API

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

1、HttpServletRequest

2、HttpServletResponse

3、HttpSession

@RequestMapping(value="/quick20")
@ResponseBody
public void save20(HttpServletRequest request, HttpServletResponse response, HttpSession session) throws IOException {
        System.out.println(request);
        System.out.println(response);
        System.out.println(session);
}
//在浏览器输入http:localhost:8080/user/quick20，就可以看到终端获取到了这三个API的地址值

获得请求头信息1

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

@RequestHeader注解的属性如下:

1、value: 请求头的名称

2、required: 是否必须携带此请求头

@RequestMapping(value="/quick21")
@ResponseBody
public void save21(@RequestHeader(value = "User-Agent",required = false) String user_agent) throws IOException {
        //上面那行的User-Agent是浏览器里的请求头。表示把User-Agent的信息(值)赋值给user_agent
        //required = false表示即使不带响应头，也可以正常访问
        System.out.println(user_agent);
}

/*打开浏览器，打开开发者工具(F12)，输入http:localhost:8080/user/quick21，点击Network(抓包工具)，点击出现的quick21，下滑找到如下:
Reaponse Headers响应头
Request Headers请求头，在这个的下面找到User-Agent，该值就是当前客户端浏览器的信息，我们可以通过注解把该值获取到，输出在控制台
同理，我们不仅可以获取到请求头的User-Agent对应的值，其实我们可以获取请求头里面的任何信息，例如Host或Cookie，只需要把上面代码的User-Agent改为Host或Cookie即可*/

//访问: http:localhost:8080/user/quick21。就可在终端获取到该响应头的信息，如下
//Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/110.0.0.0 Safari/537.36

获得请求头信息2

@RequestHeader注解可以获取到'Cookie: JSESSIONID=02D1B44226370E7A72C479848577D443'，如果我们只需要JSESSIONID后面的值呢，可以使用下面的@CookieValue注解，可以专门获取JSESSIONID后面的值。JSESSIONID是Cookie的名字，JSESSIONID的值是Cookie的值。使用@CookieValue可以获得指定Cookie的值

@Cookie注解的属性如下:

1、value: 指定cookie的名称

2、required: 释放必须携带此cookie

@RequestMapping(value="/quick22")
@ResponseBody
public void save22(@CookieValue(value = "JSESSIONID",required = false) String jsessionId) throws IOException {
        //上面那行的User-Agent是浏览器里的请求头。表示把User-Agent的信息(值)赋值给user_agent
        //required = false表示即使不带响应头，也可以正常访问
        System.out.println(jsessionId);
}

//访问: http:localhost:8080/user/quick22。就可在终端获取到该响应头的信息，如下
//02D1B44226370E7A72C479848577D443