Spring MVC 解读——@RequestMapping
上一篇文章中我们了解了Spring如何处理@RequestMapping注解,并将请求映射信息保存到系统中以处理客户端发送来的请求,但是Spring是怎样接受请求,并根据请求URL来匹配正确的处理器方法呢,更重要的是Spring允许我们定义签名灵活的处理器方法,也就是说你的参数类型,顺序,返回类型都可以自定义,只要你方便就好。真的很棒,但是他怎样做到的呢? 这篇文章我们就研究这个问题。
一、重要的类和接口
-
HandlerMethodArgumentResolver 一个策略接口,根据请求解析处理方法的参数值(这是重点),我们就是通过实现它来自定义我们的参数类型的。Spring默认提供了十多个类型的解析器来处理常见的方法参数,如@PathVariabe,@RequestParam, Model,@ModelAttribute等等。
-
HandlerMethodReturnValueHandler 一个策略接口,用来处理处理器方法的返回值(重点啊), 我们通过实现它来自定义我们的返回类型
-
RequestMappingHandlerAdapter 一个HandlerAdapter的实现类,用来处理HandlerMethod,它包含了上面两个接口一系列实现类的列表,用于处理不同的参数和返回类型
-
HandlerMethodArgumentResolverComposite 这个类 维护了一个MethodParameter 与 HandlerMethodArgumentResolver的映射表,可以快速检索某一MethodParameter对应的Resolver,并调用Resolver进行参数解析。
-
HandlerMethodReturnValueHandlerComposite 这个类只维护了一个所有HandlerMethodReturnValueHandler的列表,每次遍历检索支持某返回类型的处理器。
-
ModelAndViewContainer 这个类记录了Model和View的对应关系,可快速检索某个视图对应的Model。
说明:当我们阅读@RequestMapping注解的说明时会了解到,Spring的处理器方法默认支持诸多参数类型和返回值类型,并提供了每一个参数类型,返回值类型的解析器和处理器,上述1,2两个接口的实现类,我们大致看一下他们的类层次结构:


以上是方法参数的可能类型以及他们的解析器,Spring默认支持还是挺棒的,可以应付绝大多数需求了。


以上是可能的返回值类型和他们的处理器,同样Spring的默认支持很强大,我们都可以实现自己的参数解析器和返回值处理器。
我们可以看到支持的类型非常多,由于篇幅限制,我们只讲解最常用的一个或几个,如@PathVariable,@RequestParam,Model等,如果有兴趣大家可以自行研究,思路都一样。
二、找到请求对应的处理方法
我们知道Spring会通过DispatcherServlet来处理所有的请求,那么我们就看他是怎么处理的
1protected void doDispatch(HttpServletRequest request, HttpServletResponse response) { 2 HttpServletRequest processedRequest = request; 3 HandlerExecutionChain mappedHandler = null; 4 AsyncExecutionChain asyncChain = AsyncExecutionChain.getForCurrentRequest(request); 5 try { 6 ModelAndView mv = null; 7 Exception dispatchException = null; 8 try { 9 processedRequest = checkMultipart(request); 10 // 确定当前请求的处理器(HandlerExecutionChain 包含Handler和Interceptor列表) 11 mappedHandler = getHandler(processedRequest, false); 12 if (mappedHandler == null || mappedHandler.getHandler() == null) { 13 noHandlerFound(processedRequest, response);//404异常 14 return; 15 } 16 // 确定当前请求的处理器适配器 17 HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler()); 18 //......省略诸多代码...... 19 // 调用处理处理器方法,返回ModelAndView对象 20 mv = ha.handle(processedRequest, response, mappedHandler.getHandler()); 21 }//处理返回结果 22 processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException); 23 } 24 }
相信这个方法大家都很熟了,我删除了一些与当前主体无关的代码,下面我们看getHandler是怎么做的:
1protected HandlerExecutionChain getHandler(HttpServletRequest request) throws Exception { 2 //这里有一个handlerMappings实例变量,如果你看过<mvc:annotation-driven/>那篇文章,相信你就知道这 3 //个handlerMappings都包括哪些HandlerMapping实例了? 4 for (HandlerMapping hm : this.handlerMappings) { 5 HandlerExecutionChain handler = hm.getHandler(request); 6 if (handler != null) { 7 return handler; 8 } 9 } 10 return null; 11 }
mvc:annotation-driven/这篇博客 中说明了在启用该标签时Spring会默认注册RequestMappingHandlerMapping实例在处理@RequestMapping注解,而@RequestMapping (1) 这篇博客说明了该HandlerMapping是如何处理@RequestMapping注解,以及怎么保存请求映射关系的。下面我们就看RequestMappingHandlerMapping的getHandler方法:
1//..... 2//AbstractHandlerMapping 3//..... 4public final HandlerExecutionChain getHandler(HttpServletRequest request) throws Exception { 5 Object handler = getHandlerInternal(request);//调用下面的方法 6 if (handler == null) { 7 handler = getDefaultHandler(); 8 } 9 if (handler == null) { 10 return null; 11 } 12 // Bean name or resolved handler? 13 if (handler instanceof String) { 14 String handlerName = (String) handler; 15 handler = getApplicationContext().getBean(handlerName); 16 }//返回该请求对应的HandlerExecutionChain(包括处理器方法和拦截器) 17 return getHandlerExecutionChain(handler, request); 18 } 19//..... 20//AbstractHandlerMethodMapping(RequestMappingHandlerMapping 的祖先类) 21//返回值是HandlerMethod 22//..... 23@Override 24 protected HandlerMethod getHandlerInternal(HttpServletRequest request) throws Exception { 25 String lookupPath = getUrlPathHelper().getLookupPathForRequest(request); 26 ///查找请求路径对应的HandlerMethod实例 27 HandlerMethod handlerMethod = lookupHandlerMethod(lookupPath, request); 28 //确保HandlerMethod中的handler是处理器实例而不是处理器名字 29 return (handlerMethod != null) ? handlerMethod.createWithResolvedBean() : null; 30 }
以上两个方法都是RequestMappingHandlerMapping的祖先类,逻辑很简单,先获取当前请求的路径,然后查找该路径对应的HandlerMethod实例。@RequestMapping (1)
这篇博客最后讲到了,RequestMappingHandlerMapping中的两个映射表实例,urlMap和handlerMethods,第一个是路径与RequestMappingInfo的映射,第二个是RequestMappingInfo和HandlerMethod的映射,不用说,lookupHandlerMethod方法肯定是检索这两个变量了:
1protected HandlerMethod lookupHandlerMethod(String lookupPath, HttpServletRequest request){ 2 List<Match> matches = new ArrayList<Match>(); 3 //查找urlMap,获取直接匹配的RequestMappingInfo列表。如 4 //URL 是/work/produce/2, @RequestMapping("/work/produce/2")直接匹配 5 List<T> directPathMatches = this.urlMap.get(lookupPath); 6 if (directPathMatches != null) { 7 addMatchingMappings(directPathMatches, matches, request); 8 } 9 if (matches.isEmpty()) {//如果没有找到直接匹配项,遍历所有的注册的RequestMappingInfo来查找 10 //遍历所有可能的RequestMappingInfo,找到完全匹配的RequestMappingInfo实例,并生成Match对象 11 //添加到Match列表中,Match是RequestMappingInfo和HandlerMethod的临时映射表。 12 //举个例子:请求URL可能是GET:/work/produce/2, 13 //而@RequestMapping("/work/produce/{no}" "GET")此时需要匹配是否是GET请求,以及模式是否匹配 14 addMatchingMappings(this.handlerMethods.keySet(), matches, request); 15 } 16 if (!matches.isEmpty()) {//排序,找出最佳匹配 17 Comparator<Match> comparator = new MatchComparator(getMappingComparator(request)); 18 Collections.sort(matches, comparator); 19 Match bestMatch = matches.get(0); 20 if (matches.size() > 1) {//如果可能的方法多余一个 21 Match secondBestMatch = matches.get(1);//并且两个方法的@RequestMapping内容相同 22 if (comparator.compare(bestMatch, secondBestMatch) == 0) {//抛出异常 23 Method m1 = bestMatch.handlerMethod.getMethod(); 24 Method m2 = secondBestMatch.handlerMethod.getMethod(); 25 throw new IllegalStateException( 26 "Ambiguous handler methods mapped for HTTP path"); 27 } 28 } 29 //这里是处理请求路径中的变量,如果/work/produce/{no}匹配的/work/produce/2中将no=2 30 //添加到Request的属性表中,以便后面@PathVarible参数的处理 31 handleMatch(bestMatch.mapping, lookupPath, request); 32 return bestMatch.handlerMethod; 33 } 34 else { 35 return handleNoMatch(handlerMethods.keySet(), lookupPath, request); 36 } 37 }
在进行URL匹配中,Spring会先查找是否存在直接匹配的RequestMappingInfo实例,即@RequestMapping中的value,method属性完全匹配请求的,如果没有找到通常是存在PathVariable的,如果上面讲的/{no}和/222的情况等也是匹配的, 找到匹配项后,需要找出最优解,然后将路径中的变量存入Request的变量表中,我们分别详细的了解下:
1private void addMatchingMappings(Collection<T> mappings, List<Match> matches, 2 HttpServletRequest request) { 3 for (T mapping : mappings) {//遍历所有的RequestMappingInfo列表 4 T match = getMatchingMapping(mapping, request);//获取匹配的RequestMappingInfo实例 5 if (match != null) {//并生成匹配的RequestMappingInfo实例和对应HandlerMethod的Match实例 6 matches.add(new Match(match, handlerMethods.get(mapping))); 7 } 8 } 9 }
继续看getMatchingMapping的实现:
1public RequestMappingInfo getMatchingCondition(HttpServletRequest request) { 2 //查看RequestMappingInfo的所有属性是否匹配 3 RequestMethodsRequestCondition methods = methodsCondition.getMatchingCondition(request); 4 ParamsRequestCondition params = paramsCondition.getMatchingCondition(request); 5 HeadersRequestCondition headers = headersCondition.getMatchingCondition(request); 6 ConsumesRequestCondition consumes = consumesCondition.getMatchingCondition(request); 7 ProducesRequestCondition produces = producesCondition.getMatchingCondition(request); 8 if (methods == null || params == null || headers == null 9 || consumes == null || produces == null) { 10 return null; 11 }//我们重点看这个,路径是否匹配 12 PatternsRequestCondition patterns = patternsCondition.getMatchingCondition(request); 13 if (patterns == null) { 14 return null; 15 } 16 RequestConditionHolder custom = customConditionHolder.getMatchingCondition(request); 17 if (custom == null) { 18 return null; 19 } 20 return new RequestMappingInfo(patterns, methods, params, headers, 21 produces, custom.getCondition()); 22 }
我们知道RequestMappingInfo就是@RequestMapping注解的抽象,它包含@RequestMapping中的所有属性,因此在查找匹配项时,需要查看所有这些属性是否与请求匹配。我们这里只看路径模式是否匹配,其他属性自行研究,都很简单:
1public PatternsRequestCondition getMatchingCondition(HttpServletRequest request) { 2 if (this.patterns.isEmpty()) { 3 return this; 4 }//获取请求路径如/work/produce/2 5 String lookupPath = this.urlPathHelper.getLookupPathForRequest(request); 6 List<String> matches = new ArrayList<String>(); 7 //遍历@RequestMapping中的所有模式 8 for (String pattern : patterns) { 9 //找出与请求路径匹配的模式,如/work/produce/{no} 10 String match = getMatchingPattern(pattern, lookupPath); 11 if (match != null) { 12 matches.add(match); 13 } 14 }//排序 15 Collections.sort(matches, this.pathMatcher.getPatternComparator(lookupPath)); 16 //返回匹配的请求模式实例 17 return matches.isEmpty() ? null : 18 new PatternsRequestCondition(matches, this.urlPathHelper, this.pathMatcher, 19 this.useSuffixPatternMatch, this.useTrailingSlashMatch); 20 } 21 22private String getMatchingPattern(String pattern, String lookupPath) { 23 if (pattern.equals(lookupPath)) { 24 return pattern;//直接匹配 25 } 26 if (this.useSuffixPatternMatch) {//是否使用后缀模式,/abc/de匹配/abc 27 boolean hasSuffix = pattern.indexOf('.') != -1; 28 if (!hasSuffix && this.pathMatcher.match(pattern + ".*", lookupPath)) { 29 return pattern + ".*"; 30 } 31 }//匹配/work/produce/{no} 和/work/produce/2 32 if (this.pathMatcher.match(pattern, lookupPath)) { 33 return pattern; 34 }//是否使用结尾的斜线匹配 35 boolean endsWithSlash = pattern.endsWith("/"); 36 if (this.useTrailingSlashMatch) { 37 if (!endsWithSlash && this.pathMatcher.match(pattern + "/", lookupPath)) { 38 return pattern +"/"; 39 } 40 } 41 return null; 42 }
至于上面的pathMatcher.match方法这里就不分析了,可以自己看看,匹配算法还是比较复杂的,主要是尽可能的全面,除了进行匹配外,还会将路径中的变量保存起来以便@PathVariable参数使用。
以上便是整个的匹配过好麻烦,或许你会说这会不会降低Spring的性能?实话说,在处理首次请求时,效率是很差,但是Spring使用了各种缓存策略,一旦程序进入正轨,效率就非常高了。
三、处理器方法的调用
现在我们已经查找到了对应请求的处理器方法,下面我们就看Spring是如何在运行时动态地调用处理器方法的,并传递正确的参数。在doDispatch方法中,我们看到,确定了处理器(方法)后,Spring接着获取了该处理器方法的适配器(HandlerAdapter概念讲解中说到过,用来调用处理器方法的)
1protected HandlerAdapter getHandlerAdapter(Object handler) throws ServletException { 2 //这个handlerAdapters跟handlerMappings一样,启用<mvc:annoation-driven/>后默认注册 3 //RequestMappingHandlerAdapter(since3.1) 4 for (HandlerAdapter ha : this.handlerAdapters) { 5 if (ha.supports(handler)) { 6 return ha; 7 } 8 } 9 throw new ServletException("No adapter for handler [" + handler + 10 "]: Does your handler implement a supported interface like Controller?"); 11 } 12//是否支持当前处理器,其实就是看看处理器是不是HandlerMethod实例 13public final boolean supports(Object handler) { 14 return handler instanceof HandlerMethod && supportsInternal((HandlerMethod) handler); 15 }
获取了HandlerAdapter后,Spring就会调用handlerAdapter实例的handle方法,并返回ModelAndView实例:
1@Override 2 protected final ModelAndView handleInternal(HttpServletRequest request, 3 HttpServletResponse response, HandlerMethod handlerMethod) throws Exception { 4 //如果HandlerMethod所属的处理器被@SessionAttribute注解标记了 5 if (getSessionAttributesHandler(handlerMethod).hasSessionAttributes()) { 6 //设置响应头信息,防止缓存以便Session属性的管理 7 checkAndPrepare(request, response, this.cacheSecondsForSessionAttributeHandlers, true); 8 } 9 else { 10 //设置响应头,缓存默认时间 11 checkAndPrepare(request, response, true); 12 } 13 //要求在Session级别上进行同步,即同一个客户端的多个请求需要阻塞调用该处理器方法 14 if (this.synchronizeOnSession) { 15 HttpSession session = request.getSession(false); 16 if (session != null) { 17 Object mutex = WebUtils.getSessionMutex(session); 18 synchronized (mutex) {//调用 19 return invokeHandleMethod(request, response, handlerMethod); 20 } 21 } 22 }//调用 23 return invokeHandleMethod(request, response, handlerMethod); 24 }
我们接着看invokeHandlerMethod方法:
1private ModelAndView invokeHandleMethod(HttpServletRequest request, 2 HttpServletResponse response, HandlerMethod handlerMethod) throws Exception { 3 //包装请求和响应对象 4 ServletWebRequest webRequest = new ServletWebRequest(request, response); 5 //获取与HandlerMethod对应的DataBinderFactory。 6 WebDataBinderFactory binderFactory = getDataBinderFactory(handlerMethod); 7 //获取处理器方法所属处理器中被@ModelAttribute标记,但是没有被@RequestMapping标记的方法 8 ModelFactory modelFactory = getModelFactory(handlerMethod, binderFactory); 9 //创建请求映射方法,并将HandlerAdapter中的参数解析器列表和返回值处理器列表传递给它。 10 ServletInvocableHandlerMethod requestMappingMethod = 11 createRequestMappingMethod(handlerMethod, binderFactory); 12 //创建ModelAndViewContainer 13 ModelAndViewContainer mavContainer = new ModelAndViewContainer(); 14 mavContainer.addAllAttributes(RequestContextUtils.getInputFlashMap(request)); 15 modelFactory.initModel(webRequest, mavContainer, requestMappingMethod); 16 mavContainer.setIgnoreDefaultModelOnRedirect(this.ignoreDefaultModelOnRedirect); 17 //获取并设置当前请求的异步调用链实例 18 AsyncExecutionChain chain = AsyncExecutionChain.getForCurrentRequest(request); 19 chain.addDelegatingCallable(getAsyncCallable(mavContainer, modelFactory, webRequest)); 20 chain.setAsyncWebRequest(createAsyncWebRequest(request, response)); 21 chain.setTaskExecutor(this.taskExecutor); 22 //调用该处理器方法。 23 requestMappingMethod.invokeAndHandle(webRequest, mavContainer); 24 25 if (chain.isAsyncStarted()) { 26 return null; 27 } 28 //获取并返回ModelAndView 29 return getModelAndView(mavContainer, modelFactory, webRequest); 30 }
关于异步调用链那块我们暂不关心,后续文章会专题讨论。从上面代码可以看到,在调用方法前,分别检查了处理器中存在的@InitBinder注解的方法和@ModelAttribute注解的方法,InitBinder方法用于类型转化,如将String转化为Date类型等,可以通过@InitBinder方法实现,感兴趣可以自己看看,不在详细分析。至于@ModelAttribute注解的方法,其返回值会被放入Model对象中供视图使用。下面我们看invokeAndHandle方法:
1public final void invokeAndHandle(ServletWebRequest webRequest, 2 ModelAndViewContainer mavContainer, Object... providedArgs) throws Exception { 3 //....省略异步调用方法,暂不考虑 4 Object returnValue = invokeForRequest(webRequest, mavContainer, providedArgs); 5 //....省略几行代码,暂不考虑 6 try {//处理返回结果 7 this.returnValueHandlers.handleReturnValue(returnValue, 8 getReturnValueType(returnValue), mavContainer, webRequest); 9 } 10 }
接着我们看下invokeForRequest方法:----we are so close.
1public final Object invokeForRequest(NativeWebRequest request, 2 ModelAndViewContainer mavContainer, 3 Object... providedArgs) throws Exception { 4 //获取方法参数值。 5 Object[] args = getMethodArgumentValues(request, mavContainer, providedArgs); 6 //传递参数值,调用,返回返回值 7 Object returnValue = invoke(args); 8 return returnValue; 9 }
啊哈上面的代码貌似很简单,实则不是,重点就在getMethodArgumentValues方法,这才是我们这片文章的真正主题呢。打起精神来了:
1private Object[] getMethodArgumentValues( 2 NativeWebRequest request, ModelAndViewContainer mavContainer, 3 Object... providedArgs) throws Exception { 4 //获取处理器方法的MethodParameter数组,就是方法的“参数定义”列表。 5 MethodParameter[] parameters = getMethodParameters(); 6 Object[] args = new Object[parameters.length]; 7 //遍历所有方法参数 8 for (int i = 0; i < parameters.length; i++) { 9 MethodParameter parameter = parameters[i]; 10 parameter.initParameterNameDiscovery(parameterNameDiscoverer); 11 //确定泛型参数的类型 12 GenericTypeResolver.resolveParameterType(parameter, getBean().getClass()); 13 //根据提供的参数值,解析当前参数的值 14 args[i] = resolveProvidedArgument(parameter, providedArgs); 15 if (args[i] != null) { 16 continue; 17 } 18 //根据内置的参数解析器(上面的图片中列出了),来解析当前的参数值 19 if (argumentResolvers.supportsParameter(parameter)) { 20 try { 21 args[i] = argumentResolvers.resolveArgument(parameter, mavContainer, 22 request, dataBinderFactory); 23 continue; 24 } 25 } 26 //如果参数值依旧为空,抛出异常。 27 if (args[i] == null) { 28 String msg = getArgumentResolutionErrorMessage("No suitable resolver for argument", i); 29 throw new IllegalStateException(msg); 30 } 31 } 32 return args; 33 }
该方法是HandlerMethod中的方法,因此可以调用getMethodParameters()方法获取参数列表,然后遍历这些参数,分别用参数解析器来解析当前参数值,其中,argumentResolvers是HandlerMethodArgumentResolverComposite,概念讲解中已经阐述,它包含了所有的参数解析器的列表,以及参数类型和解析器的映射表,我们不妨看看到底什么怎么回事:
1//是的,这个方法是HandlerAdapter中的方法,上一篇文章我们介绍了这是InitializingBean接口中的方法, 2//会被自动调用 3public void afterPropertiesSet() { 4 if (this.argumentResolvers == null) { 5 //调用下面的方法,获取所有某人参数解析器。 6 List<HandlerMethodArgumentResolver> resolvers = getDefaultArgumentResolvers(); 7 //这个是HandlerAdapterComposite实例。 8 this.argumentResolvers = new HandlerMethodArgumentResolverComposite() 9 .addResolvers(resolvers); 10 } 11 if (this.initBinderArgumentResolvers == null) { 12 List<HandlerMethodArgumentResolver> resolvers = 13 getDefaultInitBinderArgumentResolvers(); 14 this.initBinderArgumentResolvers = new HandlerMethodArgumentResolverComposite() 15 .addResolvers(resolvers); 16 }//注册默认返回值处理器 17 if (this.returnValueHandlers == null) { 18 List<HandlerMethodReturnValueHandler> handlers = getDefaultReturnValueHandlers(); 19 this.returnValueHandlers = new HandlerMethodReturnValueHandlerComposite() 20 .addHandlers(handlers); 21 } 22 } 23 24 /** 25 * Return the list of argument resolvers to use including built-in resolvers 26 * and custom resolvers provided via {@link #setCustomArgumentResolvers}. 27 */ 28 private List<HandlerMethodArgumentResolver> getDefaultArgumentResolvers() { 29 List<HandlerMethodArgumentResolver> resolvers 30 = new ArrayList<HandlerMethodArgumentResolver>(); 31 32 // Annotation-based argument resolution 33 resolvers.add(new RequestParamMethodArgumentResolver(getBeanFactory(), false)); 34 resolvers.add(new RequestParamMapMethodArgumentResolver()); 35 resolvers.add(new PathVariableMethodArgumentResolver()); 36 resolvers.add(new PathVariableMapMethodArgumentResolver()); 37 resolvers.add(new ServletModelAttributeMethodProcessor(false)); 38 resolvers.add(new RequestResponseBodyMethodProcessor(getMessageConverters())); 39 resolvers.add(new RequestPartMethodArgumentResolver(getMessageConverters())); 40 resolvers.add(new RequestHeaderMethodArgumentResolver(getBeanFactory())); 41 resolvers.add(new RequestHeaderMapMethodArgumentResolver()); 42 resolvers.add(new ServletCookieValueMethodArgumentResolver(getBeanFactory())); 43 resolvers.add(new ExpressionValueMethodArgumentResolver(getBeanFactory())); 44 45 // Type-based argument resolution 46 resolvers.add(new ServletRequestMethodArgumentResolver()); 47 resolvers.add(new ServletResponseMethodArgumentResolver()); 48 resolvers.add(new HttpEntityMethodProcessor(getMessageConverters())); 49 resolvers.add(new RedirectAttributesMethodArgumentResolver()); 50 resolvers.add(new ModelMethodProcessor()); 51 resolvers.add(new MapMethodProcessor()); 52 resolvers.add(new ErrorsMethodArgumentResolver()); 53 resolvers.add(new SessionStatusMethodArgumentResolver()); 54 resolvers.add(new UriComponentsBuilderMethodArgumentResolver()); 55 56 // Custom arguments 57 if (getCustomArgumentResolvers() != null) { 58 resolvers.addAll(getCustomArgumentResolvers()); 59 } 60 61 // Catch-all 62 resolvers.add(new RequestParamMethodArgumentResolver(getBeanFactory(), true)); 63 resolvers.add(new ServletModelAttributeMethodProcessor(true)); 64 65 return resolvers; 66 }
这下清晰了吧,RequestMappingHandlerAdapter实现了InitializingBean接口,因此Spring启动是会调用它的afterPropertySet方法,进行上述参数解析器的注册。然后在处理器方法调用过程中会遍历这些解析器找到支持当前参数的解析器并解析参数。Perfect。我们再回到之前的resolveArgument方法:
1public Object resolveArgument( 2 MethodParameter parameter, ModelAndViewContainer mavContainer, 3 NativeWebRequest webRequest, WebDataBinderFactory binderFactory) 4 throws Exception { 5 //调用下面的方法回去支持当前参数类型的解析器。 6 HandlerMethodArgumentResolver resolver = getArgumentResolver(parameter); 7 //调用该解析器的解析方法进行解析。 8 return resolver.resolveArgument(parameter, mavContainer, webRequest, binderFactory); 9 } 10 //前面说过了,HandlerAdapterComposite会维护一个MethodParameter到解析器的映射关系。没错吧 11 private HandlerMethodArgumentResolver getArgumentResolver(MethodParameter parameter) { 12 HandlerMethodArgumentResolver result = this.argumentResolverCache.get(parameter); 13 if (result == null) { 14 for (HandlerMethodArgumentResolver methodArgumentResolver : argumentResolvers) { 15 //判断解析器是否支持当前参数类型 16 if (methodArgumentResolver.supportsParameter(parameter)) { 17 result = methodArgumentResolver; 18 this.argumentResolverCache.put(parameter, result); 19 break; 20 } 21 } 22 } 23 return result; 24 }
再往下就到某个解析器怎样解析具体参数了,我们知道就像上面图片中描述的,有大约一二十个解析器,我们不可能全部分析,这里我们只分析其中常见的一个:@PathVariable注解的解析器。
1public boolean supportsParameter(MethodParameter parameter) { 2 //如果该参数没有被@PathVariable注解标记,则返回false,不支持 3 if (!parameter.hasParameterAnnotation(PathVariable.class)) { 4 return false; 5 } 6 //如果该参数是Map类型的。则判断@PathVariable是否设置了value属性 7 if (Map.class.isAssignableFrom(parameter.getParameterType())) { 8 String paramName = parameter.getParameterAnnotation(PathVariable.class).value(); 9 return StringUtils.hasText(paramName); 10 } 11 return true; 12 }
从上面代码我们知道PathVariableMethodArgumentResolver支持被@PathVariable注解的参数。下面我们看它怎样解析参数值得:
1public final Object resolveArgument( 2 MethodParameter parameter, ModelAndViewContainer mavContainer, 3 NativeWebRequest webRequest, WebDataBinderFactory binderFactory) 4 throws Exception { 5 //获取参数类型 6 Class<?> paramType = parameter.getParameterType(); 7 //获取参数的名-值信息,如@PathVariable("NO") 则NO为名称,值为请求路径中对应 8 //@RequestMapping("/work/produce/NO")中NO的值。 9 NamedValueInfo namedValueInfo = getNamedValueInfo(parameter); 10 //解析请求路径中对应名称的值。上例中NO对应的值。 11 Object arg = resolveName(namedValueInfo.name, parameter, webRequest); 12 if (arg == null) { 13 if (namedValueInfo.defaultValue != null) { 14 arg = resolveDefaultValue(namedValueInfo.defaultValue); 15 } 16 else if (namedValueInfo.required) { 17 handleMissingValue(namedValueInfo.name, parameter); 18 } 19 arg = handleNullValue(namedValueInfo.name, arg, paramType); 20 }//DataBinder,后续讲解。 21 if (binderFactory != null) { 22 WebDataBinder binder = binderFactory.createBinder(webRequest, null, 23 namedValueInfo.name); 24 arg = binder.convertIfNecessary(arg, paramType, parameter); 25 } 26 //将上面解析到的名称和值放到Request的属性表中。 27 handleResolvedValue(arg, namedValueInfo.name, parameter, mavContainer, webRequest); 28 return arg; 29 }
上面代码首先获取参数的@PathVariable的value属性值,如果value是空,则将参数的名称作为NameValueInfo的name值,然后用这个name值匹配请求路径中的变量值,作为NameValueInfo的value值。
1protected Object resolveName(String name, MethodParameter parameter, NativeWebRequest request){ 2 Map<String, String> uriTemplateVars =//从请求的属性表中获取值 3 (Map<String, String>) request.getAttribute( 4 HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE, RequestAttributes.SCOPE_REQUEST); 5 return (uriTemplateVars != null) ? uriTemplateVars.get(name) : null; 6 }
上面再lookupHandlerMethod方法中,调用了handleMatch方法,我们说了它会将解析到的路径变量放到request的变量表中,这不,这里就用到了,这样我们就获取到了@PathVariable对应参数的值了。到此为止,@PathVariable参数的解析就算完成了,其他类型的参数解析思路一样不同的就是resolveArgument方法中的逻辑了,大家可以自行了解。
注:这里Spring用到了多种设计模式,包括组合模式,策略模式,适配器模式等。其实这些实现都是3.1v的,之前的版本,参数解析这块相当乱,几乎完全在一个方法内实现的,拓展性,维护性相当差,3.1后我们可以很轻松的实现自己的参数解析器等,真的很棒。
真的很累了。。。。。。
四、返回值的处理
上一节我们分析了参数的解析,及方法的调用,下面我们再来看返回值的处理,回到HandlerMethod的invokeAndHandle方法来,该方法的最后调用了returnValueHandlers.handleReturenValue方法,其中returnValueHandlers是HandlerMethodReturnValueHandlerComposite实例,就像HandlermethodArgumentResolverComposite一样,它包含了所有HandlerMethodReturnValueHandler的列表,并在Spring启动时完成注册。
1public void handleReturnValue( 2 Object returnValue, MethodParameter returnType, 3 ModelAndViewContainer mavContainer, NativeWebRequest webRequest) 4 throws Exception { 5 6 HandlerMethodReturnValueHandler handler = getReturnValueHandler(returnType); 7 handler.handleReturnValue(returnValue, returnType, mavContainer, webRequest); 8} 9 10private HandlerMethodReturnValueHandler getReturnValueHandler(MethodParameter returnType) { 11 for (HandlerMethodReturnValueHandler returnValueHandler : returnValueHandlers) { 12 if (returnValueHandler.supportsReturnType(returnType)) { 13 return returnValueHandler; 14 } 15 } 16 return null; 17} 18//这个是处理String类型的返回值,即将返回值解析为视图名------ViewNameMethodReturnValueHandler 19public void handleReturnValue( 20 Object returnValue, MethodParameter returnType, 21 ModelAndViewContainer mavContainer, NativeWebRequest webRequest) 22 throws Exception { 23 if (returnValue == null) { 24 return; 25 } 26 else if (returnValue instanceof String) { 27 String viewName = (String) returnValue; 28 //将返回值存储为视图名 29 mavContainer.setViewName(viewName); 30 if (isRedirectViewName(viewName)) { 31 mavContainer.setRedirectModelScenario(true); 32 } 33 } 34 else { 35 throw new UnsupportedOperationException("Unexpected return type: "); 36 } 37 }
返回值的处理思路与参数的处理几乎一样了,根据不同的返回值类型,查找匹配的处理器,然后进行处理(主要就是设置Model和View了,如上面的代码将返回值解析为视图名),这里就不多说了。返回值处理完了,剩下的就是将返回值响应给客户端了,再往下就是视图的解析了,也就是我们下篇文章的主题了。
欢迎大家评论,交流。