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

2024-08-30 20:28
文章标签 java 分析 源码 springboot 请求 spring 处理 映射 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>

测试一把，没有问题。
在这里插入图片描述

这篇关于关于springboot的Rest请求映射处理的源码分析(一)的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1121841。

相关文章

JVM 的类初始化机制

JVM 的类初始化机制

前言 当你在 Java 程序中new对象时，有没有考虑过 JVM 是如何把静态的字节码（byte code）转化为运行时对象的呢，这个问题看似简单，但清楚的同学相信也不会太多，这篇文章首先介绍 JVM 类初始化的机制，然后给出几个易出错的实例来分析，帮助大家更好理解这个知识点。 JVM 将字节码转化为运行时对象分为三个阶段，分别是：loading 、Linking、initialization
阅读更多...
Spring Security 基于表达式的权限控制

Spring Security 基于表达式的权限控制

前言 spring security 3.0已经可以使用spring el表达式来控制授权，允许在表达式中使用复杂的布尔逻辑来控制访问的权限。 常见的表达式 Spring Security可用表达式对象的基类是SecurityExpressionRoot。 表达式描述hasRole([role])用户拥有制定的角色时返回true （Spring security默认会带有ROLE_前缀）,去
阅读更多...
浅析Spring Security认证过程

浅析Spring Security认证过程

类图 为了方便理解Spring Security认证流程，特意画了如下的类图，包含相关的核心认证类 概述 核心验证器 AuthenticationManager 该对象提供了认证方法的入口，接收一个Authentiaton对象作为参数; public interface AuthenticationManager {Authentication authenticate(Authenti
阅读更多...
Spring Security--Architecture Overview

Spring Security--Architecture Overview

1 核心组件 这一节主要介绍一些在Spring Security中常见且核心的Java类，它们之间的依赖，构建起了整个框架。想要理解整个架构，最起码得对这些类眼熟。 1.1 SecurityContextHolder SecurityContextHolder用于存储安全上下文（security context）的信息。当前操作的用户是谁，该用户是否已经被认证，他拥有哪些角色权限…这些都被保
阅读更多...
Spring Security基于数据库验证流程详解

Spring Security基于数据库验证流程详解

Spring Security 校验流程图 相关解释说明（认真看哦） AbstractAuthenticationProcessingFilter 抽象类 /*** 调用 #requiresAuthentication(HttpServletRequest, HttpServletResponse) 决定是否需要进行验证操作。* 如果需要验证，则会调用 #attemptAuthentica
阅读更多...
Spring Security 从入门到进阶系列教程

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门（一）：登录与退出》 《Spring-Security-入门（二）：基于数据库验证》 《Spring-Security-入门（三）：密码加密》 《Spring-Security-入门（四）：自定义-Filter》 《Spring-Security-入门（五）：在 Sprin
阅读更多...
Java架构师知识体认识

Java架构师知识体认识

源码分析 常用设计模式 Proxy代理模式Factory工厂模式Singleton单例模式Delegate委派模式Strategy策略模式Prototype原型模式Template模板模式 Spring5 beans 接口实例化代理Bean操作 Context Ioc容器设计原理及高级特性Aop设计原理Factorybean与Beanfactory Transaction 声明式事物
阅读更多...
无人叉车3d激光slam多房间建图定位异常处理方案-墙体画线地图切分方案

无人叉车3d激光slam多房间建图定位异常处理方案-墙体画线地图切分方案

墙体画线地图切分方案 针对问题：墙体两侧特征混淆误匹配，导致建图和定位偏差，表现为过门跳变、外月台走歪等 ·解决思路：预期的根治方案IGICP需要较长时间完成上线，先使用切分地图的工程化方案，即墙体两侧切分为不同地图，在某一侧只使用该侧地图进行定位 方案思路 切分原理：切分地图基于关键帧位置，而非点云。 理论基础：光照是直线的，一帧点云必定只能照射到墙的一侧，无法同时照到两侧实践考虑：关
阅读更多...
Java进阶13讲__第12讲_1/2

Java进阶13讲__第12讲_1/2

多线程、线程池 1.  线程概念 1.1  什么是线程 1.2  线程的好处 2.   创建线程的三种方式 注意事项 2.1  继承Thread类 2.1.1 认识  2.1.2  编码实现  package cn.hdc.oop10.Thread;import org.slf4j.Logger;import org.slf4j.LoggerFactory
阅读更多...
性能分析之MySQL索引实战案例

性能分析之MySQL索引实战案例

文章目录 一、前言二、准备三、MySQL索引优化四、MySQL 索引知识回顾五、总结 一、前言 在上一讲性能工具之 JProfiler 简单登录案例分析实战中已经发现SQL没有建立索引问题，本文将一起从代码层去分析为什么没有建立索引？ 开源ERP项目地址：https://gitee.com/jishenghua/JSH_ERP 二、准备 打开IDEA找到登录请求资源路径位置
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2