SpringMVC学习笔记（四）—— SpringMVC获取请求参数

04、SpringMVC获取请求参数

4.1、通过ServletAPI获取

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

【test_param.html】

<a th:href="@{/testServletAPI(username='admin',password='123456')}">测试使用ServletAPI获取请求参数</a>

【ParamController.java】

@RequestMapping("/testServletAPI")
//形参位置的request表示当前请求
public String testServletAPI(HttpServletRequest request) {
    String username = request.getParameter("username");
    String password = request.getParameter("password");
    System.out.println("username="+username+",password="+password);
    return "success";
}

4.2、通过控制器方法的形参获取请求参数

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

2、代码演示：

①参数名称不一致的情况：

【test_param.html】

<a th:href="@{/testParam(username='admin',password='123456')}">测试使用控制器的形参获取请求参数</a><br/>

【ParamController.java】

@RequestMapping("/testParam")
public String testParam(String username, String password) {
    System.out.println("username="+username+",password="+password);
    return "success";
}

②参数名称相同的情况：

例如：复选框的情况

【test_param.html】

<form th:action="@{/testParam}" method="post">
    用户名：<input type="text" name="username"><br>
    密码：<input type="password" name="password"><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>

【ParamController.java】

@RequestMapping("/testParam")
public String testParam(String username, String password, String hobby) {
    //若请求参数中出现多个同名的请求参数，可以在控制器方法的形参位置设置一个字符串类型或字符串数组来接收此请求参数
    //若使用字符串类型的形参，最终结果为请求参数的每一个值之间使用逗号拼接
    System.out.println("username="+username+",password="+password+",hobby="+hobby);
    return "success";
}

1、结果是复选框的选择用逗号拼接成一个字符串，如username=admin, password=111111, hobby=a,b

2、也可以将控制器的形参类型换成数组进行获取，如：String[] hobby，获取的结果为：username=admin,password=111111,hobby=[a, b]

3、注意：

• 若请求所传输的请求参数中有多个同名的请求参数，此时可以在控制器方法的形参中设置字符串
• 数组或者字符串类型的形参接收此请求参数 若使用字符串数组类型的形参，此参数的数组中包含了每一个数据
• 若使用字符串类型的形参，此参数的值为每个数据中间使用逗号拼接的结果

4.3、@RequestParam

1、@RequestParam

• @RequestParam是将请求参数和控制器方法的形参创建映射关系 。
• @RequestParam注解一共有三个属性：
  • value：指定为形参赋值的请求参数的参数名
  • required：设置是否必须传输此请求参数，默认值为true
    • 若设置为true时，则当前请求必须传输value所指定的请求参数，若没有传输该请求参数，且没有设置 defaultValue属性，则页面报错400：Required String parameter 'xxx' is not present；
    • 若设置为 false，则当前请求不是必须传输value所指定的请求参数，若没有传输，则注解所标识的形参的值为 null 。
  • defaultValue：不管required属性值为true或false，当value所指定的请求参数没有传输或传输的值为""时，则使用默认值为形参赋值。

2、代码演示：

【ParamController.java】

@RequestMapping("/testParam")
public String testParam(
        @RequestParam(value = "user_name",required = false,defaultValue = "hehe") String username,
        String password,
        String[] hobby) {
    System.out.println("username="+username+",password="+password+",hobby="+ Arrays.toString(hobby));
    return "success";
}

4.4、@RequestHeader

1、@RequestHeader

• @RequestHeader是将请求头信息和控制器方法的形参创建映射关系
• @RequestHeader注解一共有三个属性：（用法同@RequestParam）
  • value
  • required
  • defaultValue

2、代码演示：

【ParamController.java】

@RequestMapping("/testParam")
public String testParam(
        @RequestHeader(value = "sayhaha",required = true,defaultValue = "haha") String host) {
    System.out.println("host:" + host);
    return "success";
}

4.5、@CookieValue

1、@CookieValue

• @CookieValue是将**cookie数据和控制器方法的形参**创建映射关系
• @CookieValue注解一共有三个属性：（用法同@RequestParam）
  • value
  • required
  • defaultValue

2、注意：

①Session技术依赖于Cookie技术

②Cookie是客户端会话技术，Session是服务器端会话技术

3、通过ServletAPI创建session

HttpSession session = request.getSession();

注意：cookie会话技术默认的生命周期是浏览器开启到浏览器关闭

4、代码演示：

【ParamController.java】

@RequestMapping("/testParam")
public String testParam(
        @CookieValue(value = "JSESSIONID",required = false, defaultValue = "11") String JSESSIONID) {

    System.out.println("JSESSIONID" + JSESSIONID);
    return "success";
}

4.6、通过POJO获取请求参数

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

2、代码演示：

【test_param.html】

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

【User.java】

package com.ssm.mvc.bean;

public class User {
    private Integer id;
    private String username;
    private String password;
    private Integer age;
    private String sex;
    private String email;

    public User() {
    }

    public User(Integer id, String username, String password, Integer age, String sex, String email) {
        this.id = id;
        this.username = username;
        this.password = password;
        this.age = age;
        this.sex = sex;
        this.email = email;
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public String getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", username='" + username + '\'' +
                ", password='" + password + '\'' +
                ", age=" + age +
                ", sex='" + sex + '\'' +
                ", email='" + email + '\'' +
                '}';
    }
}

【ParamController.java】

@RequestMapping("/testBean")
public String testBean(User user) {
    System.out.println(user);
    return "success";
}

注意：

最终结果为：User{id=null, username=‘admin’, password=‘123456’, age=23, sex=‘???’, email=‘123@123.com’}

其中，sex的结果出现了乱码问题

4.7、解决获取请求参数的乱码问题

1、出现乱码问题的原因是：字符编码不一致

2、原始解决乱码问题的方法：

request.setCharacterEncoding("UTF-8");

注意：在当前controller中如此设置编码，此时DispatcherServlet已经获取了参数，且参数中已经为乱码，所以当前controller设置编码已经失去作用。

因此需要在DispatcherServlet执行前进行设置编码。

3、获取请求参数出现的乱码问题分为两种：

• 第一种是"get"请求出现的乱码：

  • 此乱码是由tomcat造成的

  • 解决方法：是在tomcat下的配置文件server.xml中设置编码

    <Connector port="8080" protocol="HTTP/1.1"
                   connectionTimeout="20000"
                   redirectPort="8443" 
    			   URIEncoding="utf-8"/>
    

• 第二种是"post"请求出现的乱码

4、解决获取请求参数的乱码问题，可以使用SpringMVC提供的编码过滤器CharacterEncodingFilter，但是必须在web.xml中进行注册

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

最终结果为：User{id=null, username=‘admin’, password=‘123456’, age=23, sex=‘男’, email=‘123@123.com’}