1
2
3
4
5
6

// org.springframework.web.servlet.HandlerAdapter
public interface HandlerAdapter {
    boolean supports(Object handler); // 判断是否支持当前处理器
    ModelAndView handle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception;
    long getLastModified(HttpServletRequest request, Object handler); // 可选：资源最后修改时间
}

1
2
3
4
5
6
7

-> org.springframework.web.servlet.DispatcherServlet#doDispatch
    -> 返回找到的第一个 HandlerAdapter。org.springframework.web.servlet.DispatcherServlet#getHandlerAdapter
        -> for-each org.springframework.web.servlet.DispatcherServlet#handlerAdapters
            -> org.springframework.web.servlet.HandlerAdapter#supports
    -> 处理请求中 last-modified header 相关事务。
        -> org.springframework.web.servlet.HandlerAdapter#getLastModified
    -> 调用 HandlerAdapter#handle 方法，即处理器逻辑。org.springframework.web.servlet.HandlerAdapter#handle

1
2
3
4
5
6

// Extension of AbstractHandlerMethodAdapter that supports @RequestMapping annotated HandlerMethods.
// org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter
public class RequestMappingHandlerAdapter extends AbstractHandlerMethodAdapter
		implements BeanFactoryAware, InitializingBean {}
// instanceof HandlerAdapter, InitializingBean
// instanceof WebApplicationObjectSupport, ApplicationObjectSupport

1
2
3
4
5
6

// org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#requestMappingHandlerAdapter
@Bean
public RequestMappingHandlerAdapter requestMappingHandlerAdapter(
        @Qualifier("mvcContentNegotiationManager") ContentNegotiationManager contentNegotiationManager,
        @Qualifier("mvcConversionService") FormattingConversionService conversionService,
        @Qualifier("mvcValidator") Validator validator) {}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#requestMappingHandlerAdapter
-> org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#createRequestMappingHandlerAdapter
    -> new RequestMappingHandlerAdapter()
-> 配置 contentNegotiationManager 属性
-> 配置 messageConverters
    -> org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#getMessageConverters
        -> 使用委托类配置 messageConverters。org.springframework.web.servlet.config.annotation.DelegatingWebMvcConfiguration#configureMessageConverters
            -> for-each org.springframework.web.servlet.config.annotation.WebMvcConfigurerComposite#delegates 调用 delegate.configureMessageConverters(converters)。
        -> 配置默认 messageConverters。org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#addDefaultHttpMessageConverters
            -> 配置默认 messageConverters，包括 ByteArrayHttpMessageConverter、StringHttpMessageConverter 等。
            -> XML 格式消息转换器配置。if (!shouldIgnoreXml && jackson2XmlPresent), then add MappingJackson2XmlHttpMessageConverter。
            -> JSON 格式消息转换器配置。
                -> if (jackson2Present), then add MappingJackson2HttpMessageConverter。jackson2Present = ClassUtils.isPresent("com.fasterxml.jackson.databind.ObjectMapper", classLoader) && ClassUtils.isPresent("com.fasterxml.jackson.core.JsonGenerator", classLoader);
                -> else if (gsonPresent), then add GsonHttpMessageConverter。
                -> else if (jsonbPresent), then add JsonbHttpMessageConverter
        -> 配置扩展 messageConverters。org.springframework.web.servlet.config.annotation.WebMvcConfigurerComposite#extendMessageConverters
            -> for-each org.springframework.web.servlet.config.annotation.WebMvcConfigurerComposite#delegates 调用 org.springframework.web.servlet.config.annotation.WebMvcConfigurer#extendMessageConverters。
    -> 配置属性。org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#setMessageConverters
-> 配置 WebBindingInitializer。
    -> 获取 ConfigurableWebBindingInitializer，调用 org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration.EnableWebMvcConfiguration#getConfigurableWebBindingInitializer。
        -> 通常无法获取有效 bean，进入下一步的兜底逻辑。调用 this.beanFactory.getBean(ConfigurableWebBindingInitializer.class)。
        -> org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#getConfigurableWebBindingInitializer
            -> new ConfigurableWebBindingInitializer
            -> 配置属性，包括 ConversionService，Validator。
            -> org.springframework.web.servlet.config.annotation.DelegatingWebMvcConfiguration#getMessageCodesResolver
                -> org.springframework.web.servlet.config.annotation.WebMvcConfigurerComposite#getMessageCodesResolver
                    -> for-each org.springframework.web.servlet.config.annotation.WebMvcConfigurerComposite#delegates, then org.springframework.web.servlet.config.annotation.WebMvcConfigurer#getMessageCodesResolver
                    -> 当前该方法返回 null。
-> 配置 CustomArgumentResolvers
    -> org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#getArgumentResolvers
        -> 此时 org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#argumentResolvers 为空。
        -> org.springframework.web.servlet.config.annotation.DelegatingWebMvcConfiguration#addArgumentResolvers
            -> org.springframework.web.servlet.config.annotation.WebMvcConfigurerComposite#addArgumentResolvers
            -> 当前 this.delegates 的实现类均无有效逻辑。
-> 配置 CustomReturnValueHandlers            
    -> org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#getReturnValueHandlers
        -> 此时 org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#returnValueHandlers 为空。
            -> org.springframework.web.servlet.config.annotation.WebMvcConfigurerComposite#addReturnValueHandlers
            -> 当前 this.delegates 的实现类均无有效逻辑。
-> if (jackson2Present)，配置 JsonViewRequestBodyAdvice 和 JsonViewResponseBodyAdvice，功能与注解 JsonView.class 有关。
-> 配置 AsyncSupportConfigurer。暂时略。
    -> new AsyncSupportConfigurer
    -> org.springframework.web.servlet.config.annotation.DelegatingWebMvcConfiguration#configureAsyncSupport
-> 配置 CallableInterceptors，此时为空。
-> 配置 DeferredResultInterceptor，此时为空。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#afterPropertiesSet
-> 初始化 ControllerAdvice。org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#initControllerAdviceCache
    -> 筛选 @ControllerAdvice 注解修饰的 bean，将其封装为 ControllerAdviceBean list，并排序。org.springframework.web.method.ControllerAdviceBean#findAnnotatedBeans
        -> 筛选所有 bena。BeanFactoryUtils.beanNamesForTypeIncludingAncestors(beanFactory, Object.class)
        -> 筛选 @ControllerAdvice 注解修饰的 bean。beanFactory.findAnnotationOnBean(name, ControllerAdvice.class)
        -> new ControllerAdviceBean
            -> 构造 HandlerTypePredicate，用于后续判断 bean 是否符合条件，例如通过 package 范围限定 ControllerAdvice 的作用范围。
                -> 调用 org.springframework.web.method.ControllerAdviceBean#createBeanTypePredicate(org.springframework.web.bind.annotation.ControllerAdvice)
                -> if controllerAdvice != null，从注解中解析 Predicate 信息。
                -> else 先从 beanType 中查询 @ControllerAdvice 注解，再从中解析 Predicate 信息。
        -> 排序，规则为 Order 通用规则。OrderComparator.sort(adviceBeans)
    -> for-each adviceBeans
        -> 筛选同时被 @RequestMapping 注解和 @ModelAttribute 注解修饰的方法，缓存到 org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#modelAttributeAdviceCache。
        -> 筛选被 @InitBinder 注解修饰的方法，缓存到 org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#initBinderAdviceCache。
        -> 如果 beanType instanceof RequestBodyAdvice 或 beanType instanceof ResponseBodyAdvice，缓存到 org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#requestResponseBodyAdvice。
            -> 此处解析的 RequestBodyAdvice/ResponseBodyAdvice 实现类的 bean 优先级高于其它方法配置的 bean，因此调用 `this.requestResponseBodyAdvice.addAll(0, requestResponseBodyAdviceBeans);`。
-> 初始化默认 ArgumentResolvers，即 org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#argumentResolvers。
    -> 获取默认 ArgumentResolvers，封装为 HandlerMethodArgumentResolver list。org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#getDefaultArgumentResolvers 
        -> 按类型排序的优先级降序为 Annotation-based argument resolution，Type-based argument resolution，Custom arguments，Catch-all。
        -> 常用处理器如下：
            -> 处理 @RequestBody 或 @ResponseBody 注解修饰参数的方法参数处理器。new RequestResponseBodyMethodProcessor(getMessageConverters(), this.requestResponseBodyAdvice))。
            -> 处理 @RequestParam 注解修饰的参数及部分其它场景的方法参数处理器。new RequestParamMethodArgumentResolver(getBeanFactory(), false)
                -> Supports the following:
                -> @RequestParam-annotated method arguments. This excludes Map params where the annotation does not specify a name. See RequestParamMapMethodArgumentResolver instead for such params.
                -> Arguments of type MultipartFile unless annotated with @RequestPart.
                -> Arguments of type Part unless annotated with @RequestPart.
                -> In default resolution mode, simple type arguments even if not with @RequestParam.
            -> 处理@PathVariable注解的方法参数处理器。new PathVariableMethodArgumentResolver()
        -> 自定义处理器来源为 org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#customArgumentResolvers。
        -> 兜底处理器如下：
            -> 支持范围是，参数是简单类型（如基本类型、String、Number等）且无其他注解。new RequestParamMethodArgumentResolver(getBeanFactory(), true))
            -> 其它略。
    -> new HandlerMethodArgumentResolverComposite()
    -> org.springframework.web.method.support.HandlerMethodArgumentResolverComposite#addResolvers(java.util.List<? extends org.springframework.web.method.support.HandlerMethodArgumentResolver>)
-> 初始化处理 @InitBinde 注解修饰的参数的默认 ArgumentResolvers，即 org.springframework.web.servlet.mvc.method.annotation.
RequestMappingHandlerAdapter#initBinderArgumentResolvers。
    -> 初始化处理 @InitBinde 注解修饰的参数的默认的参数处理器，封装为 HandlerMethodArgumentResolver list。org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#getDefaultInitBinderArgumentResolvers
        -> 细节略，详情参考 org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#getDefaultArgumentResolvers。
    -> new HandlerMethodArgumentResolverComposite()
    -> org.springframework.web.method.support.HandlerMethodArgumentResolverComposite#addResolvers(java.util.List<? extends org.springframework.web.method.support.HandlerMethodArgumentResolver>)
-> 初始化默认 ReturnValueHandler，即 org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#returnValueHandlers。
    -> 获取默认 MethodReturnValueHandler，封装为 HandlerMethodReturnValueHandler list。org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#getDefaultReturnValueHandlers
        -> 按类型排序的优先级降序为 Single-purpose return value types，Annotation-based return value types，Type-based argument resolution，Multi-purpose return value types，Custom arguments，Catch-all。
        -> 常用处理器如下：
            -> 处理 HttpEntity 或 ResponseEntity 类型返回值，也支持 HttpEntity 或 RequestEntity 类型参数。new HttpEntityMethodProcessor(getMessageConverters(), this.contentNegotiationManager, this.requestResponseBodyAdvice))
            -> 处理 @ResponseBody 注解或 @RestController 注解，也支持 @RequestBody 注解。new RequestResponseBodyMethodProcessor(getMessageConverters(), this.contentNegotiationManager, this.requestResponseBodyAdvice))             
    -> new HandlerMethodReturnValueHandlerComposite()
    -> org.springframework.web.method.support.HandlerMethodReturnValueHandlerComposite#addHandlers