@RequestMapping注解
@RequestMapping注解的功能
@RequestMapping注解的作用就是将请求和处理请求的控制器方法关联起来,建立映射关系。
SpringMVC接收到指定的请求,就会来找映射关系中对应的控制器方法来处理这个请求。
@RequestMapping注解的位置
@RequestMapping注解标识一个类:设置映射请求的请求路径的初始信息。
@RequestMapping注解标识一个方法:设置映射请求请求路径的具体信息。
package com.atguigu.springmvc.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* @version 1.0
* @Description
* @Author 月上叁竿
* @Date 2022-02-28 9:45
**/
@Controller
@RequestMapping(value = "/test")
public class RequestMappingController {
@RequestMapping(value = "/testRequestMapping")
public String success(){
return "success";
}
}
当@RequestMapping既标识了类,又标识了类中的方法,要请求标识了方法的请求路径,需要在前面加上标识类的请求路径:
<!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="@{/target}">访问目标页面target</a>
<a th:href="@{/test/testRequestMapping}">成功人士才能访问的界面</a>
</body>
</html>
@RequestMapping注解的value属性
@RequestMapping注解的value属性通过请求的请求地址匹配请求映射。
@RequestMapping注解的value属性是一个字符串类型的数组,表示该请求映射能够匹配多个请求地址所对应的请求。
@RequestMapping注解的value属性必须设置,至少通过请求地址匹配请求映射。
<!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="@{/target}">访问目标页面target</a>
<a th:href="@{/test/testRequestMapping}">成功人士才能访问的界面</a>
<a th:href="@{/testRequestMapping}">@RequestMapping的value属性 ---> /testRequestMapping</a>
<a th:href="@{/test}">@RequestMapping的value属性 ---> /test</a>
</body>
</html>
package com.atguigu.springmvc.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* @version 1.0
* @Description
* @Author 月上叁竿
* @Date 2022-02-28 9:45
**/
@Controller
public class RequestMappingController {
@RequestMapping(value = {"/testRequestMapping","/test"})
public String success(){
return "success";
}
}
@RequestMapping的method属性
@RequestMapping注解的method属性是通过请求的请求方式(get或post)匹配请求映射。
@RequestMapping注解的method属性是一个RequestMethod类型的数组,表示该请求映射能够匹配多种请求方式的请求。
若当前请求的请求地址满足请求映射的value属性,但是请求方式不满足method属性,则浏览器报错405:Request method ‘POST’ not supported。
<a th:href="@{/test}">@RequestMapping的method属性 ---> get</a><br>
<form th:action="@{/test}" method="post">
<input type="submit" value="@RequestMapping的method属性 ---> post">
</form>
@RequestMapping(
value = {"/testRequestMapping","/test"},
method = {RequestMethod.POST,RequestMethod.GET}
)
public String success(){
return "success";
}
对于处理指定请求方式的控制器方法,SpringMVC中提供了@RequestMapping的派生注解:
- 处理get请求的映射—> @GetMapping
- 处理post请求的映射—> @PostMapping
- 处理put请求的映射—> @PutMapping
- 处理delete请求的映射—> @DeleteMapping
常用的请求方式有:get、post、put、delete
但浏览器只支持get和post,若在form表单提交时,为method设置了其他请求方式的字符串(put或delete),则按照默认的请求方式get进行处理。
若要发送put或delete请求,需要通过spring提供的过滤器HiddenHttpMethodFilter。
@RequestMapping注解的params属性
@RequestMapping注解的params属性通过请求的请求参数匹配请求映射。
@RequestMapping注解的params属性是一个字符串类型的数组,可以通过四种表达式设置请求参数和请求映射的匹配关系:
- “param”:要求请求映射所匹配的请求必须携带param请求参数。
- “!param”:要求请求映射所匹配的请求必须不能携带param请求参数。
- “param=value”:要求请求映射所匹配的请求必须携带param请求参数,且param=value。
- “param!=value”:要求请求映射所匹配的请求必须携带param请求参数但是param!=value。
<a th:href="@{/testParamsAndHeaders(username='admin',password=123456)}">@RequestMapping的params属性</a><br>
@RequestMapping(
value = {"/testRequestMapping","/test"},
method = {RequestMethod.POST,RequestMethod.GET},
params = {"username","password=123456"}
)
public String success(){
return "success";
}
与value属性和method匹配一条即可不同,params属性必须全部匹配,否则报错。
注:若当前请求满足@RequestMapping注解的value和method属性,但是不满足params属性,此时页面报错400:Parameter conditions “username,password!=123456” not met for actual request parameters:username={admin},password={123456}
@RequestMapping注解的headers属性
@RequsetMapping注解的headers属性通过请求的请求头信息匹配请求映射。
@RequestMapping注解的headers属性是一个字符串类型的数组,可以通过四种表达式设置请求头信息和请求映射的匹配关系:
- “header”:要求请求映射所匹配的请求必须携带header请求头信息。
- “!header”:要求请求映射所匹配的请求必须不能携带header请求头信息。
- “header=value”:要求请求映射所匹配的请求必须携带header请求头信息,且header=value。
- “header!=value”:要求请求映射所匹配的请求必须携带header请求头信息但是header!=value。
若当前请求满足@RequestMapping注解的value和method属性,但是不满足headers属性,此时页面显示404错误,即资源未找到。
SpringMVC支持ant风格的路径
?:表示任意的单个字符。
*:表示任意的0个或多个字符。
**:表示任意的一层或多层目录。
注:在使用**时,只能使用/**/xxx的方式。
<a th:href="@{/aka/testAnt}">Ant风格的?</a><br>
<a th:href="@{/akkkkkkkkkka/testAnt}">Ant风格的*</a><br>
<a th:href="@{/a/a/aa/aaa/testAnt}">Ant风格的**</a><br>
@RequestMapping(value = "/a?a/testAnt")
public String testAnt1(){
return "success";
}
@RequestMapping(value = "/a*a/testAnt")
public String testAnt2(){
return "success";
}
@RequestMapping(value = "/**/testAnt")
public String testAnt3(){
return "success";
}
SpringMVC支持路径中的占位符
原始方式:/deleteUser?id=1
rest方式:/deleteUser/1
SpringMVC路径中的占位符常用于RESTful风格中,当请求路径中将某些数据通过路径的方式传输到服务器中,就可以在相应的@RequestMapping注解的value属性中通过占位符{xxx}表示传输的数据,在通过@PathVariable注解,将占位符所表示的数据赋值给控制器方法的形参
<a th:href="@{/testRest/1/admin}">测试路径的占位符---->/testRest</a>
@RequestMapping(value = "/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
Spring MVC获取请求参数
通过ServletAPI获取
将HttpServletRequest作为控制器方法的形参,此时HttpServletRequest类型的参数表示封装了当前请求的请求报文的对象。
@RequestMapping("/testServletAPI")
public String testParam(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";
}
通过控制器方法的形参获取请求参数
在控制器方法的形参位置,设置和请求参数同名的形参,当浏览器发送请求,匹配到请求映射时,在DispatcherServlet中就会将请求参数赋值给相应的形参。
<a th:href="@{/controllerGetParam(username='admin',password=123456)}">测试使用控制器参数获取请求参数</a><br>
@RequestMapping("controllerGetParam")
public String controllerGetParam(String username,String password){
System.out.println("username = " + username + ",password = " + password);
return "success";
}
若请求所传输的参数中有多个同名的请求参数,此时可以在控制器方法的形参中设置字符串数组或者字符串类型的形参接收此请求参数。
若使用字符串数组类型的形参,此参数的数组中包含了每一个数据。
若使用字符串类型的形参,此参数的值为每个数据中间使用逗号拼接的结果。
<form th:action="@{/controllerGetParam}" method="post">
<input type="text" name="user_name"><br>
<input type="password" name="password"><br>
<input type="checkbox" name="hobby" value="C++">C++
<input type="checkbox" name="hobby" value="Java">Java
<input type="checkbox" name="hobby" value="Golang">Golang<br>
<input type="submit" value="测试使用控制器参数获取请求参数"><br>
</form>
@RequestMapping("controllerGetParam")
public String controllerGetParam(
String username,
String password,
String hobby
// String[] hobby
){
System.out.println("username = " + username + ",password = " + password + ",hobby = " + hobby);// Arrays.toString(hobby)
return "success";
}
@RequestParam
@RequestParam是将请求参数和控制器方法的形参创建映射关系。
@RequestParam注解一共有三个属性:
- value:指定为形参赋值的请求参数的参数名
- required:设置是否必须传输此请求参数,默认值是true。
- defaultValue:不管required属性值是true或false,当value所指定的请求参数没有传输或传输的值为""(空串)时,则使用默认值为形参赋值。
当required设置为true时,则当前请求必须传输value所指定的请求参数,若没有传输该请求参数,且没有设置defaultValue属性,页面报错400:Required String parameter ‘xxx’ is not persent;
若设置为false,则当前请求不是必须传输value所指定的请求参数,若没有传输,则注解所标识形参的值为null。
@RequestMapping("controllerGetParam")
public String controllerGetParam(
@RequestParam(value = "user_name", required = false, defaultValue = "admin")
String username,
String password,
String hobby
){
System.out.println("username = " + username + ",password = " + password + ",hobby = " + hobby);
return "success";
}
RequestHeader
@RequestHeader是将请求头信息和控制器方法的形参创建映射关系。
@RequestHeader注解一共有三个属性:value、required、defaultValue,用法同@RequestParam一致。
@RequestMapping("controllerGetParam")
public String controllerGetParam(
@RequestParam(value = "user_name", required = false, defaultValue = "admin")
String username,
String password,
String hobby,
@RequestHeader(value = "HOST") String host,
){
System.out.println("username = " + username + ",password = " + password + ",hobby = " + hobby);
System.out.println("host =" + host);
return "success";
}
@CookieValue
@CookieValue是将cookie数据和控制器方法的形参创建映射关系。
@CookieValue注解一共有三个属性:value、required、defaultValue,用法同@RequestParam。
@RequestMapping("controllerGetParam")
public String controllerGetParam(
@RequestParam(value = "user_name", required = false, defaultValue = "admin")
String username,
String password,
String hobby,
@RequestHeader(value = "HOST") String host,
@CookieValue("JSESSIONID") String JSESSIONID
){
System.out.println("username = " + username + ",password = " + password + ",hobby = " + hobby);
System.out.println("host =" + host);
System.out.println("JSESSIONID =" + JSESSIONID);
return "success";
}
通过POJO获取请求参数
可以在控制器方法的形参位置设置一个实体类类型的形参,此时若浏览器传输的请求参数的参数名和实体类中的属性名一致,那么请求参数就会为此赋值。
<form th:action="@{/testPojo}" 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>
@RequestMapping("/testPojo")
public String testPojo(User user){
System.out.println(user);
return "success";
}
解决获取请求参数的乱码问题
解决获取请求参数的乱码问题,可以使用SpringMVC提供的编码过滤器CharacterEncodingFilter,但是必须要在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>
<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>
Spring MVC中处理编码的过滤器一定要配置到其他过滤器之前,否则无效。