1、请求映射
1.1 rest使用与原理
- @xxxMapping;
- Rest风格支持(使用HTTP请求方式动词来表示对资源的操作)
- 以前:/getUser 获取用户 /deleteUser 删除用户 /editUser 修改用户 /saveUser 保存用户
- 现在: /user GET-获取用户 DELETE-删除用户 PUT-修改用户 POST-保存用户
- 核心Filter;HiddenHttpMethodFilter
- 用法: 表单method=post,隐藏域 _method=put
- SpringBoot中手动开启
#yml文件
spring:
mvc:
hiddenmethod:
filter:
enabled: true #开启页面表单的Rest功能
@RequestMapping(value = "/user",method = RequestMethod.GET)
public String getUser(){
return "GET-张三";
}
@RequestMapping(value = "/user",method = RequestMethod.POST)
public String saveUser(){
return "POST-张三";
}
@RequestMapping(value = "/user",method = RequestMethod.PUT)
public String putUser(){
return "PUT-张三";
}
@RequestMapping(value = "/user",method = RequestMethod.DELETE)
public String deleteUser(){
return "DELETE-张三";
}
==================================================================
//在WebMvcAutoConfiguration类中
@Bean
@ConditionalOnMissingBean(HiddenHttpMethodFilter.class)
@ConditionalOnProperty(prefix = "spring.mvc.hiddenmethod.filter", name = "enabled", matchIfMissing = false)
public OrderedHiddenHttpMethodFilter hiddenHttpMethodFilter() {
return new OrderedHiddenHttpMethodFilter();
}
<form action="/user" method="post">
<input name="_method" type="hidden" value="PUT"/>
<input value="REST-PUT 提交" type="submit"/>
</form>
<form action="/user" method="post">
<input name="_method" type="hidden" value="DELETE"/>
<input value="REST-DELETE 提交" type="submit"/>
</form>
表单的method只能填写get和post,想要使用PUT和DELETE需要增加隐藏域。
Rest原理(表单提交要使用REST的时候),表单不属于客户端。
//OrderedHiddenHttpMethodFilter的父类HiddenHttpMethodFilter中的过滤方法
protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException {
HttpServletRequest requestToUse = request;
if ("POST".equals(request.getMethod()) && request.getAttribute("javax.servlet.error.exception") == null) {
String paramValue = request.getParameter(this.methodParam);
if (StringUtils.hasLength(paramValue)) {
String method = paramValue.toUpperCase(Locale.ENGLISH);
if (ALLOWED_METHODS.contains(method)) {
requestToUse = new HiddenHttpMethodFilter.HttpMethodRequestWrapper(request, method);
}
}
}
filterChain.doFilter((ServletRequest)requestToUse, response);
}
- 表单提交会带上隐藏域的_method=PUT
- 请求过来被HiddenHttpMethodFilter拦截
- 请求是否正常,并且是POST
- 获取到_method的值。
- 兼容以下请求;PUT.DELETE.PATCH
- 原生request(post),包装模式requesWrapper重写了getMethod方法,返回的是传入的_method值。
- 过滤器链放行的时候用wrapper。以后的方法比如Controller的RequestMapping识别method,调用getMethod是调用requesWrapper的。
- 请求是否正常,并且是POST
- 请求过来被HiddenHttpMethodFilter拦截
- 总体来说,为了解决form表单只能将method的值设为get或者post,SpringBoot在容器中增加一个过滤器HiddenHttpMethodFilter。当表单发送POST请求时,若表单有隐藏域的_method的值,则将request请求变为Wrapper包装类HttpMethodRequestWrapper。其getMehod的方法重写为隐藏域的_method的值(PUT、DELETE等),然后将包装类返回,让之后的过滤链或者控制器接着处理。若单单只是POST请求,则不会进入if (StringUtils.hasLength(paramValue))语句下,直接放行。
Rest使用客户端工具,
- 如PostMan直接发送Put、DELETE等方式请求,无需Filter。客户端可以直接将method的值设置为PUT或者DELETE,所以就算设置了Filter,但是request.getMethod()方法拿到的值是PUT或者DELETE,也不会进入上图的if语句。所以一般前后端分离无需配置此过滤器。
扩展:如何把_method 这个名字换成我们自己喜欢的。
//@Configuration(proxyBeanMethods = false)
public class WebConfig{
//自定义filter
@Bean
public HiddenHttpMethodFilter hiddenHttpMethodFilter(){
HiddenHttpMethodFilter methodFilter = new HiddenHttpMethodFilter();
//设置为想要的字段
methodFilter.setMethodParam("_m");
return methodFilter;
}
}
2、请求映射原理
IDEA的快捷键:
查找某个类:Ctrl+N
查找类中某个方法:Ctrl+F12
查看类的继承树:Ctrl+H
SpringMVC功能分析都从 org.springframework.web.servlet.DispatcherServlet -> doDispatch()
protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {
//...上面代码省略
try {
processedRequest = checkMultipart(request);
multipartRequestParsed = (processedRequest != request);
// 找到当前请求使用哪个Handler(Controller的方法)处理
//循环遍历所有的HandlerMapping
mappedHandler = getHandler(processedRequest);
//HandlerMapping:处理器映射。/xxx->>xxxx
//mappedHandler = getHandler(processedRequest)具体实现
protected HandlerExecutionChain getHandler(HttpServletRequest request) throws Exception {
if (this.handlerMappings != null) {
Iterator var2 = this.handlerMappings.iterator();
//遍历所有的HandlerMapping
while(var2.hasNext()) {
HandlerMapping mapping = (HandlerMapping)var2.next();
//在HandlerMapping找到能处理请求的Handler
HandlerExecutionChain handler = mapping.getHandler(request);
if (handler != null) {
return handler;
}
}
}
return null;
}
RequestMappingHandlerMapping:MappingRegistry中保存了所有@RequestMapping和handler(Controller方法)的映射规则。
所有的请求映射都在HandlerMapping中。
- SpringBoot自动配置欢迎页的 WelcomePageHandlerMapping 。访问 /能访问到index.html;
- SpringBoot自动配置了默认的 RequestMappingHandlerMapping
总体流程:
- 请求进来,遍历所有的HandlerMapping看是否有请求信息,具体是遍历拿到当前HandlerMapping mapping后,调用mapping.getHandler(request)。
- mapping.getHandler()先拿到请求路径,再遍历该HandlerMapping的MappingRegistry是否请求路径对应的handler,如果有加入到directMatchPatches。再根据请求方式method筛选最终的handler集合matches。若集合中handler数量大于1,即多个handler可以处理同一个请求,就会报错。
- 如果有就返回这个请求对应的handler
- 如果没有就是查找下一个HandlerMapping