springboot 文件设置映射关系

转载

mob64ca140eb362 2024-10-19 08:01:31

文章标签 springboot 文件设置映射关系 spring boot 请求映射原理 springmvc REST 文章分类 架构后端开发

Rest的使用与原理

我们以前写一个请求的时候总是会在@RequestMapping里面写上/getUser 获取用户、 /deleteUser 删除用户、 /updateUser 修改用户、 /saveUser 保存用户这类的请求，但是现在SpringBoot为我们提供了另外的一种方式来进行这些操作。

springboot 使用HTTP请求方式动词来表示对资源的操作 现在我们只需要写一个 /user 用GET来获取用户、 DELETE来删除用户、 PUT来修改用户、 POST来保存用户

springboot 文件设置映射关系_springboot 文件设置映射关系

使用HTML表单出现的问题

然后我们写一个表单来测试一下到底能不能行

<h1>欢迎您</h1>
测试REST风格；
<form action="/user" method="get">
    <input value="REST-GET 提交" type="submit"/>
</form>
<form action="/user" method="post">
    <input value="REST-POST 提交" type="submit"/>
</form>
<form action="/user" method="delete">
    <input value="REST-DELETE 提交" type="submit"/>
</form>
<form action="/user" method="put">
    <input value="REST-PUT 提交" type="submit"/>
</form>

springboot 文件设置映射关系_REST_02

这个时候如果我们点击DELETE提交，发现出来的结果居然是 GET-张三！！！

springboot 文件设置映射关系_REST_03

这和我们预想的结果不一致，是什么原因导致了这个结果呢？原因其实很简单，因为 HTML 表单还不支持 PUT 和 DELETE，它识别不了put和delete所以它就采用默认的get方式，因此需要对html页面代码进行修改，把它们改为post方式

<h1>欢迎您</h1>
测试REST风格；
<form action="/user" method="get">
    <input value="REST-GET 提交" type="submit"/>
</form>
<form action="/user" method="post">
    <input value="REST-POST 提交" type="submit"/>
</form>
<form action="/user" method="post">
    <input name="_method" type="hidden" value="delete"/>
    <input name="_m" type="hidden" value="delete"/>
    <input value="REST-DELETE 提交" type="submit"/>
</form>
<form action="/user" method="post">
    <input name="_method" type="hidden" value="PUT"/>
    <input value="REST-PUT 提交" type="submit"/>
</form>

这个时候你再去点击DELETE提交，会发现这次出现的是POST了，但依然不是我们想要的DELETE

springboot 文件设置映射关系_springmvc_04

这是什么原因造成的呢？让我们打开源码来一探究竟

表单提交要使用REST的原理

找到WebMvcAutoConfiguration这个类，找到下面这段代码

springboot 文件设置映射关系_spring boot_05

我们发现，请求过来之后会被HiddenHttpMethodFilter拦截，并且@ConditionalOnProperty这个注解中matchIfMissing这一个属性的默认值为false，这也就解释了为什么我们无法执行DELETE请求了。在yaml配置文件中将其改为true后再次访问DELETE请求

springboot 文件设置映射关系_springboot 文件设置映射关系_06

springboot 文件设置映射关系_springmvc_07

现在就可以正常访问了

那为什么一定要在 form 表单的 method 中写 POST 而不是 GET 呢？

继续往下看源码，在 HiddenHttpMethodFilter 类的 doFilterInternal 中给了我们解释

springboot 文件设置映射关系_spring boot_08

这个方法用来判断请求是否正常，并且是否为POST，然后它才会去获取到_method的值，那它又是如何获取到method的值的呢？

springboot 文件设置映射关系_springboot 文件设置映射关系_09

在官方源码的注释中我们就可以知道，它用一个包装模式requesWrapper重写了getMethod方法，返回的是传入的值。因此它才能执行PUT、DELETE、PATCH这些请求

以上说法仅用于 form表单提交的时候，其他情境比如直接发送Put、delete等方式请求，无需Filter，也就不需要页面表单的Rest功能了。

这也正是源码中将matchIfMissing设为false的原因，因为这项功能仅在某些场景使用，当你需要用到时将其设置为true即可。

springboot 文件设置映射关系_spring boot_10

此外，我们在使用rest的时候其实也并不需要写那么长的注解，例如

可以将
@RequestMapping(value = "/user",method = RequestMethod.GET)
简写为
@GetMapping( "/user")

事实上，当我们去查看@GetMapping这个注解的源码的时候，会发现它和前一种写法本质上是一样的，两者并无区别，只是这样写帮助我们简化了代码

springboot 文件设置映射关系_REST_11

请求映射原理

只要我们使用了请求，那必然就会要涉及到HttpServlet，我们现在就来看看这个实现的过程

springboot 文件设置映射关系_springmvc_12

我们每一层的简单介绍一下，HttpServlet这个类呢主要处理的就是doGet这些请求，到了FrameworkServlet这里呢就变成了doService，但是这里的doService方法是个抽象方法，还没有具体实现。也就是说 SpringMVC 把对doService的实现放在了下一层：DispatcherServletFrameworkServlet 部分源码：

springboot 文件设置映射关系_spring boot_13