SpringMVC框架基础详解(二) （@RequestMapping注解、SpringMVC获取请求参数）

---

一、@RequestMapping注解

1.1概念：

将请求和处理请求的控制器方法关联起来，建立映射关系。
SpringMVC 接收到指定的请求，就会来找到在映射关系中对应的控制器方法来处理这个请求。

1.2注解的位置：

@RequestMapping标识一个类：设置映射请求的请求路径的初始信息
@RequestMapping标识一个方法：设置映射请求请求路径的具体信息

@Controller 
@RequestMapping("/test") 
	public class RequestMappingController { 
	//此时请求映射所映射的请求的请求路径为：/test/testRequestMapping 
		@RequestMapping("/testRequestMapping") 
		public String testRequestMapping(){ 
		return "success";
	 }
}

1.3注解的Value属性：

@RequestMapping注解的value属性通过请求的请求地址匹配请求映射
@RequestMapping注解的value属性是一个字符串类型的数组，表示该请求映射能够匹配多个请求地址
所对应的请求
@RequestMapping注解的value属性必须设置，至少通过请求地址匹配请求映射

1.4注解的method属性

@RequestMapping注解的method属性通过请求的请求方式（get或post）匹配请求映射
@RequestMapping注解的method属性是一个RequestMethod类型的数组，表示该请求映射能够匹配
多种请求方式的请求
若当前请求的请求地址满足请求映射的value属性，但是请求方式不满足method属性，则浏览器报错
405：Request method ‘POST’ not supported

注：1、对于处理指定请求方式的控制器方法，SpringMVC中提供了@RequestMapping的派生注解
处理get请求的映射-->@GetMapping
处理post请求的映射-->@PostMapping
处理put请求的映射-->@PutMapping
处理delete请求的映射-->@DeleteMapping
2、常用的请求方式有get，post，put，delete
但是目前浏览器只支持get和post，若在form表单提交时，为method设置了其他请求方式的字符串（put或delete），则按照默认的请求方式get处理
若要发送put和delete请求，则需要通过spring提供的过滤器HiddenHttpMethodFilter，在RESTful部分会讲到.

1.5注解的params属性

@RequestMapping注解的params属性通过请求的请求参数匹配请求映射
@RequestMapping注解的params属性是一个字符串类型的数组，可以通过四种表达	式设置请求参数和请求映射的匹配关系
"param"：要求请求映射所匹配的请求必须携带param请求参数
"!param"：要求请求映射所匹配的请求必须不能携带param请求参数
"param=value"：要求请求映射所匹配的请求必须携带param请求参数且param=value
"param!=value"：要求请求映射所匹配的请求必须携带param请求参数但是	param!=value

1.6注解的headers属性

@RequestMapping注解的headers属性通过请求的请求头信息匹配请求映射
@RequestMapping注解的headers属性是一个字符串类型的数组，可以通过四种表达式设置请求头信
息和请求映射的匹配关系
"header"：要求请求映射所匹配的请求必须携带header请求头信息
"!header"：要求请求映射所匹配的请求必须不能携带header请求头信息
"header=value"：要求请求映射所匹配的请求必须携带header请求头信息且header=value
"header!=value"：要求请求映射所匹配的请求必须携带header请求头信息且header!=value
若当前请求满足@RequestMapping注解的value和method属性，但是不满足headers属性，此时页面显示404错误，即资源未找到

1.7springMVC支持ant风格的路径

？：表示任意的单个字符
*：表示任意的0个或多个字符
**：表示任意的一层或多层目录
注意：在使用**时，只能使用/**/xxx的方式

1.8 SpringMVC支持路径中的占位符（重点）

原始方式：/deleteUser?id=1
rest方式：/deleteUser/1
SpringMVC路径中的占位符常用于RESTful风格中，当请求路径中将某些数据通过路径的方式传输到服务器中，
就可以在相应的@RequestMapping注解的value属性中通过占位符{xxx}表示传输的数据，
再通过@PathVariable注解，将占位符所表示的数据赋值给控制器方法的形参。

<a th:href="@{/testRest/1/admin}">测试路径中的占位符-->/testResta><br>

@RequestMapping("/testRest/{id}/{username}") 
public String testRest(@PathVariable("id") Integer id, @PathVariable("username") String username){ System.out.println("id:"+id+",username:"+username); 
return "success"; }
//最终输出的内容为-->id:1,username:admin

二、SpringMVC获取请求参数：

2.1通过servletAPI获取

将HttpServletRequest作为控制器方法的形参，此时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";
	}

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

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

<form th:action="@{/testParam}" method="get">
    用户名: <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>

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

2.3@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所指定的请求参数没有传输或传输的值
为""时，则使用默认值为形参赋值

   @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";
    }
}

<form th:action="@{/testParam}" method="get">
    用户名: <input type="text" name="user_name"><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>

2.4 @RequestHeader

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

 @RequestMapping("/testParam")
    public String testParam(
            @RequestParam(value = "user_name" ,required = false,defaultValue = "hehe") String username,
            String password,
            String[] hobby,
            @RequestHeader(value = "say :haha",required = false,defaultValue = "haha") String host) {
        //若请求参数中出现多个同名的请求参数，可以在控制器方法的形参位置设置字符串类型或字符串数组接收此请求参数
        //若使用字符串类型的形参，最终结果为请求参数的每一个值之间使用逗号进行拼接
        System.out.println("username:" + username + "password" + password+"hobby"+ Arrays.toString(hobby));
        System.out.println("host:"+host);
        return "success";
    }

访问param后，控制台打印如下：

2.5 @CookieValue

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

@RequestMapping("/testParam")
    public String testParam(
            @RequestParam(value = "user_name" ,required = false,defaultValue = "hehe") String username,
            String password,
            String[] hobby,
            @RequestHeader(value = "say :haha",required = false,defaultValue = "haha") String host,
            @CookieValue("JSESSIONID") String JSESSIONID)  {
        //若请求参数中出现多个同名的请求参数，可以在控制器方法的形参位置设置字符串类型或字符串数组接收此请求参数
        //若使用字符串类型的形参，最终结果为请求参数的每一个值之间使用逗号进行拼接
        System.out.println("username:" + username + "password" + password+"hobby"+ Arrays.toString(hobby));
        System.out.println("host:"+host);
        System.out.println("JSESSIONID"+JSESSIONID);
        return "success";
    }

<form th:action="@{/testParam}" method="get">
    用户名: <input type="text" name="user_name"><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>

2.6 通过POJO获取请求参数

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

package cn.hncj.mvc.controller.bean;

import lombok.Data;

/**
 * Created on 2022/4/2.
 *
 * @author Hou chaof
 */
@Data
public class User {
    private Integer id;
    private String Username;
    private String password;
    private Integer age;
    private String sex;
    private String email;

}

    @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="使用POJO接收请求参数">
form>

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

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

 
    <filter>
        <filter-name>CharacterEncodingFilterfilter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilterfilter-class>
        <init-param>
            <param-name>encodingparam-name>
            <param-value>UTF-8param-value>
        init-param>
        <init-param>
            <param-name>forceResponseEncodingparam-name>
            <param-value>trueparam-value>
        init-param>
    filter>
    <filter-mapping>
        <filter-name>CharacterEncodingFilterfilter-name>
        <url-pattern>/*url-pattern>
    filter-mapping>