SpringBoot核心技术-Web开发-请求映射及其原理

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的。
• 总体来说，为了解决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