@RequestMapping(value = {"/data", "/test"}) @RequestMapping("/testParam") 

@RequestMapping 注解的 value 属性必须设置，至少通过请求地址匹配请求映射

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

补充：@RequestMapping 的派生注解
对于处理指定请求方式的控制器方法，SpringMVC中提供了@RequestMapping的派生注解
处理get请求的映射–>@GetMapping
处理post请求的映射–>@PostMapping
处理put请求的映射–>@PutMapping
处理delete请求的映射–>@DeleteMapping

补充：常用的请求方式
常用的请求方式有 get，post，put，delete，但是目前浏览器只支持get和post，若在form表单提交时，为method 设置了其他请求方式的字符串（put或delete），则按照默认的请求方式get处理。

Tips：form 不支持发送这个method设置，但 ajax 和 axios 支持。

@RequestMapping 注解的 params属性

Tips：这个属性设置的多个值必须同时满足才能触发，本属性基本不用，了解即可。

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

@RequestMapping(         value = {"/testRequestMapping", "/test"}         ,method = {RequestMethod.GET, RequestMethod.POST}         ,params = {"username","password!=123456"} ) 

若当前请求满足 value和method属性，但不满足params属性，此时页面回报错400：
Parameter conditions “username, password!=123456” not met for actual request parameters: username={admin}, password={123456}

@RequestMapping 注解的 headers 属性

基本同上，用的很少！

headers 属性通过请求的请求头信息匹配请求映射是一个字符串类型的数组，可以通过四种表达式设置请求头信息和请求映射的匹配关系。
“header”：要求请求映射所匹配的请求必须携带header请求头信息
“!header”：要求请求映射所匹配的请求必须不能携带header请求头信息
“header=value”：要求请求映射所匹配的请求必须携带header请求头信息且header=value
“header!=value”：要求请求映射所匹配的请求必须携带header请求头信息且header!=value

若当前请求满足@RequestMapping注解的value和method属性，但是不满足headers属性，此时页面显示404错误，即资源未找到

SpringMVC 支持ant风格的路径

即模糊匹配用法

？：表示任意的单个字符，有且仅能1个，不能是“/”这类型特殊字符
*：表示任意的0个或多个字符
：表示任意的一层或多层目录，只能使用//xxx的方式

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

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

获取请求参数

接收参数的方式，与请求传递的 ContentType 紧密有关，常见的有 application/x-www-form-urlencoded 和 application/json 两种类型，后续专栏介绍。

1、普通参数
可以使用 @RequestParam 注解接收，或者HttpServletRequest#getParameter接收，详细细节后续篇章介绍。
这里只能处理 x-www-form-urlencoded 类型的请求，get和post方式都可以，但 json 不行。

@ResponseBody @RequestMapping("/testParam") public String testParam(HttpServletRequest request, String xxx,                          @RequestParam("xxx2") String xxx2) {     System.out.println("xxx:" + xxx);     System.out.println("xxx2:" + xxx2);     String xxx3 = request.getParameter("xxx2");     System.out.println("xxx3:" + xxx3);     return "hello"; } 

2、POJO 类型参数
这种情况，不能使用 @RequestParam 接收，直接写实体即可，效果如下。
这里是 x-www-form-urlencoded 的示例，如果是 json 请求，直接参考上面章节，使用 @RequestBody。

@ResponseBody @RequestMapping("/testParam2") public Student testParam2(Student student) {     student.setName("战神");     return student; } 

Tips：SpringMVC会使用构造器实例化出一个pojo类对象，即Student，然后使用setXxx()方法进行赋值，如果没有构造器会报错，没有set方法那么这个成员变量就为空null值。

3、其他类型
还有数组、List、Map，以及相应的复杂结构，后续章节展开介绍。

报文信息转换

HttpMessageConverter，报文信息转换器，将请求报文转换为Java对象，或将Java对象转换为响应报文。
HttpMessageConverter提供了两个注解和两个类型：
@RequestBody，@ResponseBody，RequestEntity，ResponseEntity

@RequestBody
@RequestBody 可以获取请求体，需要在控制器方法设置一个形参，使用@RequestBody进行标识，当前请求的请求体就会为当前注解所标识的形参赋值。

   用户名：
   密码：
    
 

// 输出结果：requestBody:username=admin&password=123456 @RequestMapping("/testRequestBody") public String testRequestBody(@RequestBody String requestBody){     System.out.println("requestBody:"+requestBody);     return "success"; } 

RequestEntity
RequestEntity封装请求报文的一种类型，需要在控制器方法的形参中设置该类型的形参，当前请求的请求报文就会赋值给该形参，可以通过getHeaders()获取请求头信息，通过getBody()获取请求体信息。

@RequestMapping("/testRequestEntity") public String testRequestEntity(RequestEntity requestEntity){     System.out.println("requestHeader:"+requestEntity.getHeaders());     System.out.println("requestBody:"+requestEntity.getBody());     return "success"; } 

输出结果：
requestHeader:[host:“localhost:8080”, connection:“keep-alive”, content-length:“27”, cache-control:“max-age=0”, sec-ch-ua:“” Not A;Brand";v=“99”, “Chromium”;v=“90”, “Google Chrome”;v=“90"”, sec-ch-ua-mobile:“?0”, upgrade-insecure-requests:“1”, origin:“http://localhost:8080”, user-agent:“Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.93 Safari/537.36”]
requestBody:username=admin&password=123

@ResponseBody
@ResponseBody用于标识一个控制器方法，可以将该方法的返回值直接作为响应报文的响应体响应到浏览器

@ResponseBody 处理 json
a>导入jackson的依赖

   com.fasterxml.jackson.core   jackson-databind   2.12.1  

b>在SpringMVC的核心配置文件中开启mvc的注解驱动，此时在HandlerAdaptor中会自动装配一个消息转换器：MappingJackson2HttpMessageConverter，可以将响应到浏览器的Java对象转换为Json格式的字符串

c>在处理器方法上使用@ResponseBody注解进行标识
d>将Java对象直接作为控制器方法的返回值返回，就会自动转换为Json格式的字符串

@RestController注解
@RestController注解是springMVC提供的一个复合注解，标识在控制器的类上，就相当于为类添加了@Controller注解，并且为其中的每个方法添加了@ResponseBody注解。

ResponseEntity
ResponseEntity 用于控制器方法的返回值类型，该控制器方法的返回值就是响应到浏览器的响应报文。

文件上传下载

使用 ResponseEntity 实现下载文件的功能

@RequestMapping("/testDown") public ResponseEntity testResponseEntity(HttpSession session) throws IOException {     //获取ServletContext对象     ServletContext servletContext = session.getServletContext();     //获取服务器中文件的真实路径     String realPath = servletContext.getRealPath("/static/img/1.jpg");     //创建输入流     InputStream is = new FileInputStream(realPath);     //创建字节数组     byte[] bytes = new byte[is.available()];     //将流读到字节数组中     is.read(bytes);     //创建HttpHeaders对象设置响应头信息     MultiValueMap headers = new HttpHeaders();     //设置要下载方式以及下载文件的名字     headers.add("Content-Disposition", "attachment;filename=1.jpg");     //设置响应状态码     HttpStatus statusCode = HttpStatus.OK;     //创建ResponseEntity对象     ResponseEntity responseEntity = new ResponseEntity<>(bytes, headers, statusCode);     //关闭输入流     is.close();     return responseEntity; } 

文件上传
文件上传要求form表单的请求方式必须为post，并且添加属性enctype=“multipart/form-data”
SpringMVC中将上传的文件封装到MultipartFile对象中，通过此对象可以获取文件相关信息。

1、添加依赖：

   commons-fileupload   commons-fileupload   1.3.1  

2、在SpringMVC的配置文件中添加配置（注意ID命名一定是 multipartResolver）：

3、编写控制层代码：

@RequestMapping("/testUp") public String testUp(MultipartFile photo, HttpSession session) throws IOException {     //获取上传的文件的文件名     String fileName = photo.getOriginalFilename();     //处理文件重名问题     String hzName = fileName.substring(fileName.lastIndexOf("."));     fileName = UUID.randomUUID().toString() + hzName;     //获取服务器中photo目录的路径     ServletContext servletContext = session.getServletContext();     String photoPath = servletContext.getRealPath("photo");     File file = new File(photoPath);     if(!file.exists()){         file.mkdir();     }     String finalPath = photoPath + File.separator + fileName;     //实现上传功能     photo.transferTo(new File(finalPath));     return "success"; } 

拦截器的配置

SpringMVC 中的拦截器用于拦截控制器方法的执行。
SpringMVC 中的拦截器需要实现 HandlerInterceptor，必须在SpringMVC的配置文件中进行配置：

拦截器的三个抽象方法
SpringMVC中的拦截器有三个抽象方法：
1、preHandle：控制器方法执行之前执行preHandle()，其boolean类型的返回值表示是否拦截或放行，返回true为放行，即调用控制器方法；返回false表示拦截，即不调用控制器方法
2、postHandle：控制器方法执行之后执行postHandle()
3、afterComplation：处理完视图和模型数据，渲染视图完毕之后执行afterComplation()

拦截器的执行顺序
浏览器 - 过滤器 - DispatcherServlet - preHandle - 控制层 - postHandle - 视图渲染 - afterComplation

多个拦截器的执行顺序
a>若每个拦截器的preHandle()都返回true
此时多个拦截器的执行顺序和拦截器在SpringMVC的配置文件的配置顺序有关：
preHandle()会按照配置的顺序执行，而postHandle()和afterComplation()会按照配置的反序执行
b>若某个拦截器的preHandle()返回了false
preHandle()返回false和它之前的拦截器的preHandle()都会执行，postHandle()都不执行，返回false的拦截器之前的拦截器的afterComplation()会执行

拦截器源码分析
参考：DispatcherServlet#doDispatch

部分代码如下，关于执行顺序也从源码里面可以看出来，执行流程其实围绕着
处理执行链 HandlerExecutionChain 进行。

if (!mappedHandler.applyPreHandle(processedRequest, response)) { 	return; }  // Actually invoke the handler. mv = ha.handle(processedRequest, response, mappedHandler.getHandler());  applyDefaultViewName(processedRequest, mv); mappedHandler.applyPostHandle(processedRequest, response, mv); 

boolean applyPreHandle(HttpServletRequest request, HttpServletResponse response) throws Exception { 	HandlerInterceptor[] interceptors = getInterceptors(); 	if (!ObjectUtils.isEmpty(interceptors)) { 		for (int i = 0; i < interceptors.length; i++) { 			HandlerInterceptor interceptor = interceptors[i]; 			if (!interceptor.preHandle(request, response, this.handler)) { 				triggerAfterCompletion(request, response, null); 				return false; 			} 			this.interceptorIndex = i; 		} 	} 	return true; } 

具体示例：

//Step1. 自定义的拦截器，实现的接口HandlerInterceptor public class CustomInterceptor implements HandlerInterceptor {          @Override     public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {         //预处理，返回true则继续执行。如果需要登录校验，校验不通过返回false即可，通过则返回true。         System.out.println("执行preHandle()方法");         return true;     }      @Override     public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {         //后处理         System.out.println("执行postHandle()方法");     }      @Override     public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {         //在DispatcherServlet完全处理完请求后被调用         System.out.println("执行afterCompletion()方法");     } }  /**  * Step2. 注册拦截器到容器中，/**代表所有路径  * @param registry 拦截器注册表对象  */ @Override public void addInterceptors(InterceptorRegistry registry) {     registry.addInterceptor(new CustomInterceptor()).addPathPatterns("/**"); }  

总结陈词

此篇文章介绍了SpringMVC 项目的基础搭建和一些知识介绍，仅供参考。
后续还会继续从 SpringMVC 的常见用法、源码分析、扩展点分析、企业实战等方面展开。
💗 后续会逐步分享企业实际开发中的实战经验，有需要交流的可以联系博主。