接口
public interface HandlerAdapter { /** * 是否能处理指定Handler * @param var1 * @return */ boolean supports(Object var1); /** * 处理Handler * @param var1 * @param var2 * @param var3 * @return * @throws Exception */ @Nullable ModelAndView handle(HttpServletRequest var1, HttpServletResponse var2, Object var3) throws Exception; /** * 获取资源最后一次更新时间 * @param var1 * @param var2 * @return */ long getLastModified(HttpServletRequest var1, Object var2); }
类图
我们回到Dispatcher开始看起
DispatcherServlet
doDispatch
org.springframework.web.servlet.FrameworkServlet#service
->
org.springframework.web.servlet.FrameworkServlet#processRequest
->
org.springframework.web.servlet.DispatcherServlet#doService
->
org.springframework.web.servlet.DispatcherServlet#doDispatch
protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception { HttpServletRequest processedRequest = request; HandlerExecutionChain mappedHandler = null; boolean multipartRequestParsed = false; //获取异步管理器 WebAsyncManager asyncManager = WebAsyncUtils.getAsyncManager(request); try { try { ModelAndView mv = null; Exception dispatchException = null; try { /** * 如果配置了MultipartResolver 会调用 isMultipart() 方法判断请求中是否包含文件。 * 如果请求数据中包含文件,则调用 MultipartResolver 的 resolveMultipart() * 方法对请求的数据进行解析,然后将文件数据解析成 MultipartFile * 并封装在 MultipartHttpServletRequest (继承了 HttpServletRequest) 对象中并返回 */ processedRequest = this.checkMultipart(request); //是否被解析 multipartRequestParsed = processedRequest != request; //通过HandlerMapping获得 HandlerExecutionChanin如:org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping //org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMappin mappedHandler = this.getHandler(processedRequest); if (mappedHandler == null || mappedHandler.getHandler() == null) { //没获取到抛出404异常 this.noHandlerFound(processedRequest, response); return; } //<1>返回对应能处理的HandlerAdapter HandlerAdapter ha = this.getHandlerAdapter(mappedHandler.getHandler()); String method = request.getMethod(); boolean isGet = "GET".equals(method); if (isGet || "HEAD".equals(method)) { long lastModified = ha.getLastModified(request, mappedHandler.getHandler()); if (this.logger.isDebugEnabled()) { this.logger.debug("Last-Modified value for [" + getRequestUri(request) + "] is: " + lastModified); } if ((new ServletWebRequest(request, response)).checkNotModified(lastModified) && isGet) { return; } } //<前置处理 拦截器 if (!mappedHandler.applyPreHandle(processedRequest, response)) { return; } //<3>真正的处理方法 返回视图 没有视图则返回null mv = ha.handle(processedRequest, response, mappedHandler.getHandler()); //是否开启异步管理器 if (asyncManager.isConcurrentHandlingStarted()) { return; } //设置默认的viewName this.applyDefaultViewName(processedRequest, mv); //后置处理 拦截器 mappedHandler.applyPostHandle(processedRequest, response, mv); } catch (Exception var19) { dispatchException = var19; } //处理正常和异常的请求调用结果。 this.processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException); } catch (Exception var20) { //触发异常拦截器的AfterCompletion实现 this.triggerAfterCompletion(processedRequest, response, mappedHandler, var20); } catch (Error var21) { //触发异常拦截器的AfterCompletion实现 this.triggerAfterCompletionWithError(processedRequest, response, mappedHandler, var21); } } finally { if (asyncManager.isConcurrentHandlingStarted()) { if (mappedHandler != null) { mappedHandler.applyAfterConcurrentHandlingStarted(processedRequest, response); } } else if (multipartRequestParsed) { this.cleanupMultipart(processedRequest); } } }
<1>getHandlerAdapter
org.springframework.web.servlet.FrameworkServlet#service
->
org.springframework.web.servlet.FrameworkServlet#processRequest
->
org.springframework.web.servlet.DispatcherServlet#doService
->
org.springframework.web.servlet.DispatcherServlet#doDispatch
->
org.springframework.web.servlet.DispatcherServlet#getHandlerAdapter
protected HandlerAdapter getHandlerAdapter(Object handler) throws ServletException { if (this.handlerAdapters != null) { Iterator var2 = this.handlerAdapters.iterator(); while(var2.hasNext()) { HandlerAdapter adapter = (HandlerAdapter)var2.next(); //<2>遍历所有适配器 传入handler 判断判断adapter是否能处理 if (adapter.supports(handler)) { return adapter; } } } throw new ServletException("No adapter for handler [" + handler + "]: The DispatcherServlet configuration needs to include a HandlerAdapter that supports this handler"); }
RequestMappingHandlerAdapter
<2>supports
org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter#supports
public final boolean supports(Object handler) { //判断Handler是否是HandlerMethod 类型 supportsInternal是个抽象方法由子类实现 也就是RequestMappingHandlerAdapter return handler instanceof HandlerMethod && this.supportsInternal((HandlerMethod)handler); }
org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter#supports
->
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#supportsInternal
protected boolean supportsInternal(HandlerMethod handlerMethod) { return true; }
<3>handle
org.springframework.web.servlet.FrameworkServlet#service
->
org.springframework.web.servlet.FrameworkServlet#processRequest
->
org.springframework.web.servlet.DispatcherServlet#doService
->
org.springframework.web.servlet.DispatcherServlet#doDispatch
->
org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter#handle
public final ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { //<4>调用子类的实现 抽象方法模板方法实现 return this.handleInternal(request, response, (HandlerMethod)handler); }
<4>handleInternal
org.springframework.web.servlet.FrameworkServlet#service
->
org.springframework.web.servlet.FrameworkServlet#processRequest
->
org.springframework.web.servlet.DispatcherServlet#doService
->
org.springframework.web.servlet.DispatcherServlet#doDispatch
->
org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter#handle
->
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#handleInternal
protected ModelAndView handleInternal(HttpServletRequest request, HttpServletResponse response, HandlerMethod handlerMethod) throws Exception { //<5>检查是否配置了只能处理请求 以及是否必须存在session而没有传 this.checkRequest(request); ModelAndView mav; //是否有配置根据session加锁 if (this.synchronizeOnSession) { //true为如果不存在session则创建一个并返回 false不存在直接返回null HttpSession session = request.getSession(false); if (session != null) { /** * Object mutex = session.getAttribute(SESSION_MUTEX_ATTRIBUTE); * 如果为空则返回当前session对象 当我们有需求保证一个session原子性的时候用吧 就一个加同步锁动作 */ Object mutex = WebUtils.getSessionMutex(session); synchronized(mutex) { //<6>执行处理返回modelView mav = this.invokeHandlerMethod(request, response, handlerMethod); } } else { //<6>执行处理返回modelView mav = this.invokeHandlerMethod(request, response, handlerMethod); } } else { //<6>执行处理求返回modelView mav = this.invokeHandlerMethod(request, response, handlerMethod); } /** * 响应头Cache-Control是通知浏览器缓存 * 这里主要是@SessionAttribute用法的处理 * 很少用到 也可兼容https://blog.csdn.net/qq_38737992/article/details/89763067 处理 */ if (!response.containsHeader("Cache-Control")) { if (this.getSessionAttributesHandler(handlerMethod).hasSessionAttributes()) { this.applyCacheSeconds(response, this.cacheSecondsForSessionAttributeHandlers); } else { this.prepareResponse(response); } } return mav; }
<5>checkRequest
org.springframework.web.servlet.FrameworkServlet#service
->
org.springframework.web.servlet.FrameworkServlet#processRequest
->
org.springframework.web.servlet.DispatcherServlet#doService
->
org.springframework.web.servlet.DispatcherServlet#doDispatch
->
org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter#handle
->
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#handleInternal
->
org.springframework.web.servlet.support.WebContentGenerator#checkRequest
protected final void checkRequest(HttpServletRequest request) throws ServletException { //获得请求方式 String method = request.getMethod(); //判断是否支持 我们可以通过这个支持的请求方式 if (this.supportedMethods != null && !this.supportedMethods.contains(method)) { throw new HttpRequestMethodNotSupportedException(method, this.supportedMethods); //判断是否配置了必须存在session } else if (this.requireSession && request.getSession(false) == null) { throw new HttpSessionRequiredException("Pre-existing session required but none found"); } }
<6>invokeHandlerMethod
org.springframework.web.servlet.FrameworkServlet#service
->
org.springframework.web.servlet.FrameworkServlet#processRequest
->
org.springframework.web.servlet.DispatcherServlet#doService
->
org.springframework.web.servlet.DispatcherServlet#doDispatch
->
org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter#handle
->
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#handleInternal
->
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#invokeHandlerMethod
protected ModelAndView invokeHandlerMethod(HttpServletRequest request, HttpServletResponse response, HandlerMethod handlerMethod) throws Exception { ServletWebRequest webRequest = new ServletWebRequest(request, response); ModelAndView var15; try { WebDataBinderFactory binderFactory = this.getDataBinderFactory(handlerMethod); ModelFactory modelFactory = this.getModelFactory(handlerMethod, binderFactory); //交给ServletInvocableHandlerMethod 对象代理handlerMethod ServletInvocableHandlerMethod invocableMethod = this.createInvocableHandlerMethod(handlerMethod); //入参绑定器 set 后续使用 if (this.argumentResolvers != null) { invocableMethod.setHandlerMethodArgumentResolvers(this.argumentResolvers); } //方绘制绑定器 if (this.returnValueHandlers != null) { invocableMethod.setHandlerMethodReturnValueHandlers(this.returnValueHandlers); } invocableMethod.setDataBinderFactory(binderFactory); invocableMethod.setParameterNameDiscoverer(this.parameterNameDiscoverer); ModelAndViewContainer mavContainer = new ModelAndViewContainer(); mavContainer.addAllAttributes(RequestContextUtils.getInputFlashMap(request)); modelFactory.initModel(webRequest, mavContainer, invocableMethod); mavContainer.setIgnoreDefaultModelOnRedirect(this.ignoreDefaultModelOnRedirect); AsyncWebRequest asyncWebRequest = WebAsyncUtils.createAsyncWebRequest(request, response); //异步超时时间 asyncWebRequest.setTimeout(this.asyncRequestTimeout); WebAsyncManager asyncManager = WebAsyncUtils.getAsyncManager(request); //设置线程池 asyncManager.setTaskExecutor(this.taskExecutor); asyncManager.setAsyncWebRequest(asyncWebRequest); //拦截器 asyncManager.registerCallableInterceptors(this.callableInterceptors); //DeferredResult方式拦截器 asyncManager.registerDeferredResultInterceptors(this.deferredResultInterceptors); Object result; /** * 主要针对我们返回值是Callable 会释放Dispatcher占用的线程 交给的taskExecutor之心你那个 但是与客户端连接还保持 * 当拿回结果 从新走Dispatcher入口进来 这里判断就会是true */ if (asyncManager.hasConcurrentResult()) { result = asyncManager.getConcurrentResult(); mavContainer = (ModelAndViewContainer)asyncManager.getConcurrentResultContext()[0]; asyncManager.clearConcurrentResult(); LogFormatUtils.traceDebug(this.logger, (traceOn) -> { String formatted = LogFormatUtils.formatValue(result, !traceOn); return "Resume with async result [" + formatted + "]"; }); //同时这类替换invocableMethod为ServletInvocableHandlerMethod.ConcurrentResultHandlerMethod 继承ServletInvocableHandlerMethod invocableMethod = invocableMethod.wrapConcurrentResult(result); } //<7>执行后续请求处理 invocableMethod.invokeAndHandle(webRequest, mavContainer, new Object[0]); if (asyncManager.isConcurrentHandlingStarted()) { result = null; return (ModelAndView)result; } //<如果我们返回ModelAndView则会被ModelAndViewMethodReturnValueHandler 封装到 mavContainenr 这里则根据MavContainer获取 var15 = this.getModelAndView(mavContainer, modelFactory, webRequest); } finally { webRequest.requestCompleted(); } return var15; }
ServletInvocableHandlerMethod
<7>invokeAndHandle
org.springframework.web.servlet.FrameworkServlet#service
->
org.springframework.web.servlet.FrameworkServlet#processRequest
->
org.springframework.web.servlet.DispatcherServlet#doService
->
org.springframework.web.servlet.DispatcherServlet#doDispatch
->
org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter#handle
->
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#handleInternal
->
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#invokeHandlerMethod
->
org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod#invokeAndHandle
public void invokeAndHandle(ServletWebRequest webRequest, ModelAndViewContainer mavContainer, Object... providedArgs) throws Exception { //<7_1>执行参数绑定 执行控制器方法取回返回结果 Object returnValue = this.invokeForRequest(webRequest, mavContainer, providedArgs); this.setResponseStatus(webRequest); if (returnValue == null) { if (this.isRequestNotModified(webRequest) || this.getResponseStatus() != null || mavContainer.isRequestHandled()) { mavContainer.setRequestHandled(true); return; } } else if (StringUtils.hasText(this.getResponseStatusReason())) { mavContainer.setRequestHandled(true); return; } mavContainer.setRequestHandled(false); //必须返回值处理器 Assert.state(this.returnValueHandlers != null, "No return value handlers"); try { //<10>通过返回值处理器进行返回值处理 this.returnValueHandlers.handleReturnValue(returnValue, this.getReturnValueType(returnValue), mavContainer, webRequest); } catch (Exception var6) { if (this.logger.isTraceEnabled()) { this.logger.trace(this.formatErrorForReturnValue(returnValue), var6); } throw var6; } }
<7_1>invokeForRequest
org.springframework.web.servlet.FrameworkServlet#service
->
org.springframework.web.servlet.FrameworkServlet#processRequest
->
org.springframework.web.servlet.DispatcherServlet#doService
->
org.springframework.web.servlet.DispatcherServlet#doDispatch
->
org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter#handle
->
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#handleInternal
->
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#invokeHandlerMethod
->
org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod#invokeAndHandle
->
org.springframework.web.method.support.InvocableHandlerMethod#invokeForRequest
public Object invokeForRequest(NativeWebRequest request, @Nullable ModelAndViewContainer mavContainer, Object... providedArgs) throws Exception { //<8>通过绑定器绑定参数 Object[] args = this.getMethodArgumentValues(request, mavContainer, providedArgs); if (this.logger.isTraceEnabled()) { this.logger.trace("Arguments: " + Arrays.toString(args)); } //<9>调用对应的controller方法 return this.doInvoke(args); }
<8>getMethodArgumentValues
org.springframework.web.method.support.InvocableHandlerMethod#getMethodArgumentValues
protected Object[] getMethodArgumentValues(NativeWebRequest request, @Nullable ModelAndViewContainer mavContainer, Object... providedArgs) throws Exception { //获得对应的绑定参数 MethodParameter[] parameters = this.getMethodParameters(); Object[] args = new Object[parameters.length]; for(int i = 0; i < parameters.length; ++i) { MethodParameter parameter = parameters[i]; parameter.initParameterNameDiscovery(this.parameterNameDiscoverer); //这里是优先获取 @Init方法注册的合适的绑定器 返回的类型绑定器 args[i] = this.resolveProvidedArgument(parameter, providedArgs); if (args[i] == null) { //遍历所有参数绑定器找到合适的绑定器 if (this.argumentResolvers.supportsParameter(parameter)) { try { //解析出参数 args[i] = this.argumentResolvers.resolveArgument(parameter, mavContainer, request, this.dataBinderFactory); } catch (Exception var10) { if (this.logger.isDebugEnabled()) { String message = var10.getMessage(); if (message != null && !message.contains(parameter.getExecutable().toGenericString())) { this.logger.debug(formatArgumentError(parameter, message)); } } throw var10; } } else if (args[i] == null) { throw new IllegalStateException(formatArgumentError(parameter, "No suitable resolver")); } } } //返回参数 return args; }
<9>doInvoke
org.springframework.web.method.support.InvocableHandlerMethod#doInvoke
protected Object doInvoke(Object... args) throws Exception { ReflectionUtils.makeAccessible(this.getBridgedMethod()); try { //反射调用对应的Method方法 return this.getBridgedMethod().invoke(this.getBean(), args); } catch (IllegalArgumentException var4) { this.assertTargetBean(this.getBridgedMethod(), this.getBean(), args); String text = var4.getMessage() != null ? var4.getMessage() : "Illegal argument"; throw new IllegalStateException(this.formatInvokeError(text, args), var4); } catch (InvocationTargetException var5) { Throwable targetException = var5.getTargetException(); if (targetException instanceof RuntimeException) { throw (RuntimeException)targetException; } else if (targetException instanceof Error) { throw (Error)targetException; } else if (targetException instanceof Exception) { throw (Exception)targetException; } else { throw new IllegalStateException(this.formatInvokeError("Invocation failure", args), targetException); } } }
<10>handleReturnValue
org.springframework.web.method.support.InvocableHandlerMethod#handleReturnValue
public void handleReturnValue(@Nullable Object returnValue, MethodParameter returnType, ModelAndViewContainer mavContainer, NativeWebRequest webRequest) throws Exception { //<11>根据响应值和响应参数选取合适的BindType HandlerMethodReturnValueHandler handler = this.selectHandler(returnValue, returnType); if (handler == null) { throw new IllegalArgumentException("Unknown return value type: " + returnType.getParameterType().getName()); } else { //写入body 我们可以自定义绑定在写入之前执行一些逻辑 handler.handleReturnValue(returnValue, returnType, mavContainer, webRequest); } }
<11>selectHandler
org.springframework.web.method.support.InvocableHandlerMethod#selectHandler
@Nullable private HandlerMethodReturnValueHandler selectHandler(@Nullable Object value, MethodParameter returnType) { boolean isAsyncValue = this.isAsyncReturnValue(value, returnType); Iterator var4 = this.returnValueHandlers.iterator(); HandlerMethodReturnValueHandler handler; do { do { if (!var4.hasNext()) { return null; } handler = (HandlerMethodReturnValueHandler)var4.next(); } while(isAsyncValue && !(handler instanceof AsyncHandlerMethodReturnValueHandler)); //返回supportsReturnType 调用判断是否能处理 } while(!handler.supportsReturnType(returnType)); return handler; }
如:RequestBody绑定器的实现
public boolean supportsReturnType(MethodParameter returnType) { return AnnotatedElementUtils.hasAnnotation(returnType.getContainingClass(), ResponseBody.class) || returnType.hasMethodAnnotation(ResponseBody.class); }
总结
1.RequestMappingHandlerAdapter最终内部会将请求委托给ServletInvocableHandlerMethod处理
2.ServletInvocableHandlerMethod 会先经过参数绑定器获得参数args数组
3.然后通能反射调用Controller的对应方法
4.再通过响应绑定器对不同的响应内容做处理 比如解析@ResponseBody的响应处理器