文章目录
4 SpringMVC获取请求参数
4.1 通过ServletAPI获取
将HttpServletRequest作为控制器方法的形参,此时HttpServletRequest类型的参数表示封装了当前请求的请求报文的对象
新创建一个ParamController的类:
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpSession;
@Controller
public class ParamController {
@RequestMapping("/param")
public String param(){
return "test_param";
}
@RequestMapping("/testServletAPI")
public String testServletAPI(HttpServletRequest request){
HttpSession session = request.getSession();
String username = request.getParameter("username");
String password = request.getParameter("password");
System.out.println("username:"+username+",password:"+password);
return "success";
}
}
再新创建一个test_param.html页面:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8" >
<title>测试请求参数</title>
</head>
<body>
<h1>测试请求参数</h1>
<a th:href="@{/testServletAPI(username='admin',password=123456)}">测试使用servletAPI获取请求参数</a><br>
</body>
</html>
点击链接后实现跳转,并且控制台输出参数信息:
4.2 通过控制器方法的形参获取请求参数
在控制器方法的形参位置,设置和请求参数同名的形参,当浏览器发送请求,匹配到请求映射时,在DispatcherServlet中就会将请求参数赋值给相应的形参
在Controller中新增加以下方法
@RequestMapping("/testParam")
public String testParam(String username, String password){
System.out.println("username:"+username+",password:"+password);
return "success";
}
在前端页面增加以下代码中
<a th:href="@{/testParam(username='admin',password=123456)}">测试获取请求参数-->/testParam</a><br>
点击链接控制台打印:
注:
若请求所传输的请求参数中有多个同名的请求参数,此时可以在控制器方法的形参中设置字符串数组或者字符串类型的形参接收此请求参数
若使用字符串数组类型的形参,此参数的数组中包含了每一个数据
若使用字符串类型的形参,此参数的值为每个数据中间使用逗号拼接的结果
4.3 @RequestParam、@RequestHeader与@CookieValue注解
- @RequestParam是将请求参数和控制器方法的形参创建映射关系
- @RequestHeader是将请求头信息和控制器方法的形参创建映射关系
- @CookieValue是将cookie数据和控制器方法的形参创建映射关系
这三个注解一共有三个属性:
-
value:指定为形参赋值的请求参数的参数名
-
required:设置是否必须传输此请求参数,默认值为true
若设置为true时,则当前请求必须传输value所指定的请求参数,若没有传输该请求参数,且没有设置defaultValue属性,则页面报错400:Required String parameter ‘xxx’ is not present;若设置为false,则当前请求不是必须传输value所指定的请求参数,若没有传输,则注解所标识的形参的值为null
-
defaultValue(比较常用):不管required属性值为true或false,当value所指定的请求参数没有传输或传输的值为""时,则使用默认值为形参赋值
现在以@RequestParam来讲解、其它两个用法与它一致
实例展示:
@RequestMapping("/testParam")
public String testParam(
@RequestParam(value="user_name",required = true)String username,
@RequestParam(value="pwd",required = false)String password,
String[] hobby){
System.out.println("username:"+username+",password:"+password+ ",hobby:"+Arrays.toString(hobby));
return "success";
}
在test_param前端页面加入以下代码:
<form th:action="@{/testParam}" method="get">
用户名:<input type="text" name="user_name"><br>
密码:<input type="password" name="pwd"><br>
爱好:<input type="checkbox" name="hobby" value="a">a
<input type="checkbox" name="hobby" value="b">b
<input type="checkbox" name="hobby" value="c">c<br>
<input type="submit" value="测试使用控制器的形参获取请求参数">
</form>
此时正常填写表单:
结果如下:
不发送password:
http://localhost:8080/springMVC_war_exploded/testParam?user_name=zjw&hobby=a&hobby=b&hobby=c
不发送user_name:
http://localhost:8080/springMVC_war_exploded/testParam?&pwd=&hobby=a&hobby=b&hobby=c
测试defaultValue属性:
http://localhost:8080/springMVC_war_exploded/testParam?user_name=zjw&hobby=a&hobby=b&hobby=c
4.4 通过POJO获取请求参数
可以在控制器方法的形参位置设置一个实体类类型的形参,此时若浏览器传输的请求参数的参数名和实体类中的属性名一致,那么请求参数就会为此属性赋值
新创建一个User类,类中有以下成员变量:
增加以下控制器方法:
@RequestMapping("/testBean")
public String testBean(User user){
System.out.println(user);
return "success";
}
在前端页面增加以下表单:
<form th:action="@{/testBean}" method="post">
用户名:<input type="text" name="username"><br>
密码:<input type="password" name="password"><br>
性别:<input type="radio" name="sex" value="男">男<input type="radio" name="sex" value="女">女<br>
年龄:<input type="text" name="age"><br>
邮箱:<input type="text" name="email"><br>
<input type="submit" value="使用实体类接收请求参数">
</form>
在表单中填写内容:
但是根据结果发现为什么sex的值为“??”(乱码),是因为它现在没有配置请求参数的字符编码,所以接下来我们就解决获取请求参数的乱码问题。
4.5 解决获取请求参数的乱码问题
解决获取请求参数的乱码问题,可以使用SpringMVC提供的编码过滤器CharacterEncodingFilter
,但是必须在web.xml中进行注册
<!--配置springMVC的编码过滤器-->
<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>
<init-param>
<param-name>forceResponseEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<!-- 拦截请求映射,拦截所有请求-->
<filter-mapping>
<filter-name>CharacterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
注:
SpringMVC中处理编码的过滤器一定要配置到其他过滤器之前,否则无效
填写表单:
此时控制台打印的结果页没有出现乱码
那么CharacterEncodingFilter做了什么呢?
此时我们进入它的源码(按住Ctrl点击进入)
我们在web.xml改的就是这两个东西:
那么真正修改编码格式的代码在哪里呢?我们往下拉,找到doFilterInternal这个方法。在这里,我们可以清晰地看到request和response调用了setCharacterEncoding方法来设置这个编码格式。
根据源码我们可以看到,如果想成功设置编码,需要满足几个if条件,首先我们观察设置request的条件:
要么ForceRequestEncoding为true,要么request.getCharacterEncoding()为null,而默认情况下ForceRequestEncoding是flase的,而getCharacterEncoding是返回null的,所以默认情况下是满足第二个表达式的,可以将encoding改成我们设置的编码格式。
那么如何满足response的条件呢,我们需要将ForceResponseEncoding设置为true,也就是我们在web.xml代码中修改的:
如此,便可以把客户端和服务器的编码格式都变为UTF-8了。
当然还有另一种写法,我们看它里面有一个setter注入的方法如下:
这个方法将ForceRequestEncoding与ForceResponseEncoding同时设置为true,让两个if条件都成立。
所以,我们在web.xml的语句也可以用:
foreEncoding
来替换代码中的 foreResponseEncoding