# 4.SpringMVC获取请求参数

# 1.通过ServletAPI获取

将HttpServletRequest作为控制器方法的形参,此时HttpServletRequest类型的参数表示封装了当前请求的请求报文的对象

通过原生 Servlet API 获取请求参数的方式,核心是利用 HttpServletRequest 对象来获取前端传递的参数。

    @RequestMapping("/testParam")
    public String testParam(HttpServletRequest request){
        String username = request.getParameter("username");
        String password = request.getParameter("password");
        System.out.println("username:"+username+",password:"+password);
        return "success";
    }
1
2
3
4
5
6
7

# 2.通过控制器方法的形参获取请求参数

在控制器方法的形参位置,设置和请求参数同名的形参,当浏览器发送请求,匹配到请求映射时,在DispatcherServlet中就会将请求参数赋值给相应的形参

    @RequestMapping("/testParam2")
    public String testParam2(String username,String password,String[] hobby){
        //当有多个形参名称和参数名称一致时,可以通过String[] 获取参数值,通过Arrays.toString()方法获取参数值
        //也可通过String来获取参数值,结果是用逗号分隔
        System.out.println("username:"+username+",password:"+password+",hobby:"+ Arrays.toString(hobby));
        return "success";
    }
1
2
3
4
5
6
7
<form th:action="@{/testParam2}" method="get">
    <input type="text" name="username" value="admin"><br>
    <input type="password" name="password" value="12345"><br>
    <input type="checkbox" name="hobby" value="1">a</input>
    <input type="checkbox" name="hobby" value="2">b</input>
    <input type="checkbox" name="hobby" value="3">c</input>
    <input type="submit" value="提交"></input>
</form>
1
2
3
4
5
6
7
8

注:

  1. 若请求所传输的请求参数中有多个同名的请求参数,此时可以在控制器方法的形参中设置字符串数组或者字符串类型的形参接收此请求参数

  2. 若使用字符串数组类型的形参,此参数的数组中包含了每一个数据

  3. 若使用字符串类型的形参,此参数的值为每个数据中间使用逗号拼接的结果


# 3.@RequestParam

@RequestParam是将请求参数和控制器方法的形参创建映射关系

@RequestParam注解一共有三个属性:

value:指定为形参赋值的请求参数的参数名 required:设置是否必须传输此请求参数,默认值为true

若设置为true时,I则当前请求必须传输value所指定的请求参数,若没有传输该请求参数,且没有设置defaultValue属性,则页面报错400:Required String parameter 'xxx'is not present; 若设置为false,则当前请求不是必须传输value所指定的请求参数,若没有传输,则注解所标识的形参的值为null

defaultValue:不管required属性值为true或false,当value所指定的请求参数没有传输时,则使用默认值为形参赋值

@RequestMapping("/testParam2")
    public String testParam2(
            @RequestParam(name = "username",required = false ,defaultValue = "admin") String username,
                             String password,
                             String[] hobby){
        System.out.println("username:"+username+",password:"+password+",hobby:"+ Arrays.toString(hobby));
        return "success";
    }
1
2
3
4
5
6
7
8

# 4.@RequestHeader

@RequestHeader是将请求头信息和控制器方法的形参创建映射关系

@RequestHeader注解一共有三个属性:value、required、defaultValue,用法同@RequestParam

  @RequestMapping("/testParam2")
    public String testParam2(
            @RequestParam(name = "username",required = false ,defaultValue = "admin") String username,
                             String password,
                             String[] hobby,
            @RequestHeader(value = "Host",required = false,defaultValue = "localhost") String host)
    {
        //当有多个形参名称和参数名称一致时,可以通过String[] 获取参数值,通过Arrays.toString()方法获取参数值
        //也可通过String来获取参数值,结果是用逗号分隔
        System.out.println("username:"+username+",password:"+password+",hobby:"+ Arrays.toString(hobby));
        System.out.println("host:"+host);
        return "success";
    }
1
2
3
4
5
6
7
8
9
10
11
12
13

找到请求头为Host的值赋值给host,如果没有,将默认值赋值给host


# 5.@CookieValue

@CookieValue是将cookie数据和控制器方法的形参创建映射关系

@CookieValue注解一共有三个属性:value、required、defaultValue,用法同@RequestParam

注:

我们要先在任一方法中使用session并且访问那个页面才能获取JSESSIONID,也就是SessionID,因为一开始,服务器会分配给你一个sessionID响应回去,以后的每次访问都会带着这个SessionID来请求服务区。


# 6.通过POJO获取请求参数

可以在控制器方法的形参位置设置一个实体类类型的形参,此时若浏览器传输的请求参数的参数名和实体类中的属性名一致,那么请求参数就会为此属性赋值

<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>
    <input type="radio" name="sex" value=""></input><br>
    邮箱:<input type="text" name="email"><br>
    年龄:<input type="text" name="age"><br>
    <input type="submit" value="对象参数测试"></input>
</form>
1
2
3
4
5
6
7
8
9
    @RequestMapping("/testBean")
    public String testBean(User user){
        System.out.println(user);
        return "success";
    }
1
2
3
4
5

# 7.解决乱码问题

想要解决乱码问题,必须在前端控制器处理参数前对编码进行设置,所以我们就要用到过滤器,对过滤器进行如下配置

<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>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

CharacterEncodingFilter类有如下三个参数

在放行之前对编码进行设置,所以要初始化encoding参数,以后的编码就会按照你设置的编码进行解析

 protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException {
        String encoding = this.getEncoding();
        if (encoding != null) {
            if (this.isForceRequestEncoding() || request.getCharacterEncoding() == null) {
                request.setCharacterEncoding(encoding);
            }

            if (this.isForceResponseEncoding()) {
                response.setCharacterEncoding(encoding);
            }
        }
1
2
3
4
5
6
7
8
9
10
11

isForceRequestEncoding和isForceResponseEncoding默认为false,如果你想让设置响应编码,必须将isForceResponseEncoding初始化为true,因为他只有一个判断条件


最近更新: 9/19/2026, 1:27:08 PM
编程NOTE   |