关于springboot的Rest请求映射处理的源码分析(一)

本文主要是介绍关于springboot的Rest请求映射处理的源码分析(一)，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

我们在开发中很常见的一种方式是通过请求的类型，也就是restful风格来区别我们的请求接口。
通过请求类型的不同(GET POST PUT DELETE) 来区分即便是请求路径相同的请求。
但是他的底层是如何支持的呢，明明我请求路径都是/user。就因为类型不同就能区分到不同的接口。
接下来我们就看看这部分实现。从这个实现开始，我们将会彻底打通关于springboot中的请求处理的所有原理。

一、准备测试代码

1、简易前端

我的前端属于是菜的不能再菜那种，这里我们就实现四个简单的提交表单，用来调用我们的四个接口，从而观察现象。
我们把这个html文件命名为restfulForm.html放在我们的静态资源目录下面。
在这里插入图片描述
页面的代码如下：

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Test Form</title><style>body {font-family: Arial, sans-serif;margin: 20px;}.container {max-width: 600px;margin: auto;}form {display: flex;flex-direction: column;}label {margin-bottom: 5px;font-weight: bold;}input, textarea {margin-bottom: 15px;padding: 8px;font-size: 16px;}button {padding: 10px;font-size: 16px;background-color: #4CAF50;color: white;border: none;cursor: pointer;}button:hover {background-color: #45a049;}</style>
</head>
<body>
<div class="container"><h1>Test Form</h1><form action="/user" method="get"><input value="get提交" type="submit"></form><form action="/user" method="post"><input value="post提交" type="submit"></form><form action="/user" method="put"><input value="put提交" type="submit"></form><form action="/user" method="delete"><input value="delete提交" type="submit"></form>
</div>
</body>
</html>

在这个页面中，我们就准备了四个表单提交。分别对应四个不同的接口，他们的名字都是一样的，但是其请求类型不同。

2、后端restful接口

@org.springframework.web.bind.annotation.RestController
public class RestController {@RequestMapping(value = "/user" ,method = RequestMethod.GET)public String getUser() {return "getUser";}@RequestMapping(value = "/user" ,method = RequestMethod.POST)public String postUser() {return "postUser";}@RequestMapping(value = "/user" ,method = RequestMethod.PUT)public String putUser() {return "putUser";}@RequestMapping(value = "/user" ,method = RequestMethod.DELETE)public String delUser() {return "delUser";}
}

这四个接口，名字路径都一样，但是method类型不同。这正是我们要测试的。

3、测试结果

3.1、get请求

点击get按钮，返回如下。结果没毛病。
在这里插入图片描述

3.2、post请求

点击post按钮，返回如下。结果没毛病。
在这里插入图片描述

3.3、put请求

点击put请求，返回如下。
在这里插入图片描述
出问题了，为啥返回的还是getUser。

3.4、delete请求

点击delete请求，返回如下。
在这里插入图片描述
同样的问题。

4、测试问题总结

我们看到在put和delete请求的时候，出现了我们预想之外的结果。这个不对，难道是我们有没考虑到的问题吗。

5、问题分析解决

我们以前用MVC的时候要想实现rest的请求，是需要配置一个HiddenHttpMethodFilter的过滤器的。具体使用可以看这个文档。MVC使用Restful接口
那人家MVC能解决，你来boot这里封装了MVC咋还出问题了，所以我们来看看BOOT是怎么封装的呢。
我们知道boot中关于MVC的操作都是配置在WebMvcAutoConfiguration这个配置类的。我们找到这个类。
巧的是刚打开这个类我们就看到了关于mvc中的那个HiddenHttpMethodFilter，只不过boot继承了他一下，弄了个OrderedHiddenHttpMethodFilter 出来，就是多了个排序功能，本质实现还一样。

/*** 这个是注册你对于restful风格请求的映射，当然默认是GET，但是你不配delete put是不能生效的，他会映射去你相同名字的get请求* 没有相同名字的get就404了  注意这个是表单提交的rest风格过滤器，你要是用postman这个不生效，因为表单只能写get post* 不能写delete 和 put，这里你要是原生的其实没事，这里只是为了兼容表单的* @return*/
@Bean
// 没这个才生效这个配置，我们没自己写，所以生效
@ConditionalOnMissingBean(HiddenHttpMethodFilter.class)
// 配置文件里面没有配置spring.mvc.hiddenmethod.filter.enabled=true，所以不生效，所以我们要想生效rest风格，需要配置这个
@ConditionalOnProperty(prefix = "spring.mvc.hiddenmethod.filter", name = "enabled", matchIfMissing = false)
public OrderedHiddenHttpMethodFilter hiddenHttpMethodFilter() {// 点进去看他的过滤规则/*** if ("POST".equals(request.getMethod()) && request.getAttribute(WebUtils.ERROR_EXCEPTION_ATTRIBUTE) == null) {* 			String paramValue = request.getParameter(this.methodParam);* 			if (StringUtils.hasLength(paramValue)) {* 				String method = paramValue.toUpperCase(Locale.ENGLISH);* 				if (ALLOWED_METHODS.contains(method)) {* 					requestToUse = new HttpMethodRequestWrapper(request, method);* 				                }            * 			}* 		}* 	filterChain.doFilter(requestToUse, response);放行过滤器* 	这是他过滤器的实现，我们看到你的方法必须是post，并且没有异常，然后参数里面必须有一个_method参数，这个参数的值就是你的请求方法* 	也就是你的表单要写一个name="_method" value="delete"然后他会读这个_method"，ALLOWED_METHODS这个是个数组就是put get delete post* 	那些支持的rest类型的接口，这里拿到再去给你路由，过滤器给你把你原来的get请求拿到，然后给你包装成了delete请求，然后你就可以处理delete请求了*/return new OrderedHiddenHttpMethodFilter();
}

我顺手加了一些注释，但是你可以忽视这些注释，因为下面的原理我们会提到这些东西。
所以我们看到他有一个生效注解：

@ConditionalOnProperty(prefix = "spring.mvc.hiddenmethod.filter", name = "enabled", matchIfMissing = false)

他的意思是当我们的配置文件中配了spring.mvc.hiddenmethod.filter的时候他才会生效，如果没配，他也不会帮我们matchIfMissing 。所以我们需要配置一下。
他的规则是前缀是spring.mvc.hiddenmethod.filter，然后name是enabled。所以我们的配置就是
spring.mvc.hiddenmethod.filter.enabled=true
我们再来试一试：
依然是这样。
在这里插入图片描述
难道还有我们不知道的玄机吗，既然我们配置了，那我们再去OrderedHiddenHttpMethodFilter这个类里面去看看。这个类啥也没有，就是继承了HiddenHttpMethodFilter，我们就直接去看HiddenHttpMethodFilter。

public class HiddenHttpMethodFilter extends OncePerRequestFilter {// 这里放了一个PUT和一个DELETE的类型，那个PATCH不常用private static final List<String> ALLOWED_METHODS =Collections.unmodifiableList(Arrays.asList(HttpMethod.PUT.name(),HttpMethod.DELETE.name(), HttpMethod.PATCH.name()));// 这里有个字符串_methodpublic static final String DEFAULT_METHOD_PARAM = "_method";// 这个其实还是_method字符串，套着引用了一下，无聊，可能用在不同地方表示不同的业务属性，// 名字区分一下吧private String methodParam = DEFAULT_METHOD_PARAM;/*** Set the parameter name to look for HTTP methods.* @see #DEFAULT_METHOD_PARAM* 这里应该是让用户自己扩展的，你可以传入一些参数来替代_method，回头再说*/public void setMethodParam(String methodParam) {Assert.hasText(methodParam, "'methodParam' must not be empty");this.methodParam = methodParam;}/**既然这是个过滤器类，那他的doFilterInternal看命名一定就是干活的了*/@Overrideprotected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)throws ServletException, IOException {// 获取这个servlet请求信息HttpServletRequest requestToUse = request;// 首先你的请求必须是POST请求，他才处理，而且你的请求信息里面不能有javax.servlet.error.exceptionif ("POST".equals(request.getMethod()) && request.getAttribute(WebUtils.ERROR_EXCEPTION_ATTRIBUTE) == null) {// 取出请求里面包着的_method属性的值String paramValue = request.getParameter(this.methodParam);if (StringUtils.hasLength(paramValue)) {// 一律转小写 String method = paramValue.toUpperCase(Locale.ENGLISH);// 如果你的这个_method里面的内容在delete和put里面，他就会给你处理，然后把你// 的请求包装一下if (ALLOWED_METHODS.contains(method)) {requestToUse = new HttpMethodRequestWrapper(request, method);}}}filterChain.doFilter(requestToUse, response);}
}

所以我们看到如果你的这个_method里面的内容在delete和put里面，他就会给你处理，然后把你的请求包装一下，然后传递下去，我们虽然还不知道他这里到底有何区别，但是我们看到了他这里处理了delete和put的逻辑。而且他是取出你的_method属性对应的值去看看你在不在delete和put里面，但是你的method本身还是POST，PUT也是一样的。所以我们的表单需要变成这样。

<form action="/user" method="POST"><input value="put提交" type="submit"><input name="_method" value="PUT"></form><form action="/user" method="POST"><input value="delete提交" type="submit"><input name="_method" value="DELETE"></form>

但是我们看到页面变成这样了。
在这里插入图片描述
好家伙太丑了，实际上我们新加的那个没啥用，就是一个提交个参数，用户不用看到，我们给他隐藏了提交就行。我们变成这样。

<form action="/user" method="POST"><input value="put提交" type="submit"><input name="_method" type="hidden" value="PUT">
</form>
<form action="/user" method="POST"><input value="delete提交" type="submit"><input name="_method" type="hidden" value="DELETE">
</form>

隐藏了加一个type=“hidden”，此时就可以了。
在这里插入图片描述

此时我们看到就都正常了。
此时就符合了我们的预期，下面我们就来看看到底是啥原理。

二、源码分析

其实上面我们基本已经梳理清楚了，因为表单提交只能提交GET POST,不支持delete和put，所以我们通过加了一个参数，并且请求类型都是POST，让那段代码生效，把我们原来的POST请求给包装成了delete和put请求。这样就能生效了，至于为啥包装好了，就能找到对应的controller方法，这个我们后面再说。
但是呢，注意一点，这个只是给表单生效的。如果我们用postman或者curl或者别人从其他项目直接发这类请求是不走这个逻辑的，人家从http那边直接就是delete和put请求了。不用你再转了，表单是不支持这个，所以才要包装一层。而且现在都是前后端分离了，前端项目直接请求也不用走这个逻辑。只有在springboot的表单才有用。所以你要是前后端分离，或者postman，安卓一类的，不需要配置
spring.mvc.hiddenmethod.filter.enabled=true，压根没这回事。

三、扩展点

我们上面在看源码的时候我说了两个事情。
1、@ConditionalOnMissingBean(HiddenHttpMethodFilter.class)
public OrderedHiddenHttpMethodFilter hiddenHttpMethodFilter()
OrderedHiddenHttpMethodFilter 这个组件是在容器里面没有HiddenHttpMethodFilter才生效的，所以我们可以自己写一个覆盖了他的。
2、HiddenHttpMethodFilter 中有一个属性就是methodParam ，他默认是_method，然后你表单提交一个_method才能被识别，但是我们自己写了HiddenHttpMethodFilter，完全可以不用他这个_method，我们自己改一个比如叫cjb，这样我们的表单要是改成cjb不也行吗，这是一种自己定义的风格，看你想用啥就改成啥，二话不说，我们来实践一把。

添加一个自己的HiddenHttpMethodFilter

@Configuration
public class MyHiddenHttpMethodFilterConfig{@Beanpublic HiddenHttpMethodFilter myHiddenHttpMethodFilter(){HiddenHttpMethodFilter hiddenHttpMethodFilter = new HiddenHttpMethodFilter();// 我们给它赋值一个我们自己的属性hiddenHttpMethodFilter.setMethodParam("cjb");return hiddenHttpMethodFilter;}}

修改页面那个隐藏参数为我们自己定义的cjb

<form action="/user" method="POST"><input value="put提交" type="submit"><input name="cjb" type="hidden" value="PUT">
</form>
<form action="/user" method="POST"><input value="delete提交" type="submit"><input name="cjb" type="hidden" value="DELETE">
</form>