SpringMVC系列第17篇:源码解析SpringMVC容器的启动过程

star2017 1年前 ⋅ 325 阅读

文末可以领取所有系列高清pdf。

大家好,我是路人,这是SpringMVC系列第17篇。

本文将通过阅读源码的方式带大家了解springmv容器启动的过程,SpringMVC中的各种组件都是在容器启动的过程中组装的,所以如果熟悉整个过程后,你可以随意对SpringMVC进行扩展,SpringMVC会被你玩的出神入化。

目录

1、前言

SpringMVC,建议大家使用全注解的方式,全注解的方式及原理不了解的,先去看一下这篇文章:SpringMVC全注解方式如何使用?

上面的文章看懂以后再来看本文,否则将出现消化不良的现象。

本文以全注解的方式为基础,来解说SpringMVC容器启动的整个流程。

2、回顾全注解方式2个关键类

全注解的方式重点就在于2个类:MVC初始化类、MVC配置类

2.1、MVC初始化类

代码如下,这个类需要继承AbstractAnnotationConfigDispatcherServletInitializer,会有web容器来调用,这个类中有4个方法需要实现,干了4件事情

  • getRootConfigClasses():获取父容器的配置类
  • getServletConfigClasses():获取springmvc容器的配置类,这个配置类相当于springmvc xml配置文件的功能
  • getServletMappings():获取DispatcherServlet能够处理的url,相当于web.xml中为servlet指定的url-pattern
  • getServletFilters():定义所有的Filter
  1. /**
  2. * ①:1、创建Mvc初始化类,需要继承AbstractAnnotationConfigDispatcherServletInitializer类
  3. */
  4. public class MvcInit extends AbstractAnnotationConfigDispatcherServletInitializer {
  5. /**
  6. * springmvc容器的父容器spring配置类
  7. * 实际工作中我们的项目比较复杂,可以将controller层放在springmvc容器中
  8. * 其他层,如service层、dao层放在父容器了,bean管理起来更清晰一些
  9. * 也可以没有父容器,将所有bean都放在springmvc容器中
  10. *
  11. * @return
  12. */
  13. @Override
  14. protected Class<?>[] getRootConfigClasses() {
  15. return new Class[0];
  16. }
  17. /**
  18. * ②:2、设置springmvc容器的spring配置类
  19. *
  20. * @return
  21. */
  22. @Override
  23. protected Class<?>[] getServletConfigClasses() {
  24. return new Class[]{MvcConfig.class};
  25. }
  26. /**
  27. * ③:3、配置DispatcherServlet的url-pattern
  28. *
  29. * @return
  30. */
  31. @Override
  32. protected String[] getServletMappings() {
  33. return new String[]{"/"};
  34. }
  35. /**
  36. * ④:4、注册拦截器
  37. *
  38. * @return
  39. */
  40. @Override
  41. protected Filter[] getServletFilters() {
  42. //添加拦截器,解决乱码问题
  43. CharacterEncodingFilter characterEncodingFilter = new CharacterEncodingFilter();
  44. characterEncodingFilter.setEncoding("UTF-8");
  45. characterEncodingFilter.setForceRequestEncoding(true);
  46. characterEncodingFilter.setForceResponseEncoding(true);
  47. return new Filter[]{characterEncodingFilter};
  48. }
  49. }

2.2、MVC配置类

代码如下,这个配置类相当于springmvc xml配置文件的功能,可以在里面定义springmvc各种组件

  1. /**
  2. * 1.开启springmvc注解配置
  3. * 2、配置视图解析器
  4. * 3、配置截器
  5. * 4、配置静态资源访问
  6. * 5、配置文件上传解析器
  7. * 6、配置全局异常处理器
  8. */
  9. @Configuration
  10. @ComponentScan("com.javacode2018.springmvc.chat12")
  11. @EnableWebMvc //1:使用EnableWebMvc开启springmvc注解方式配置
  12. public class MvcConfig implements WebMvcConfigurer {
  13. /**
  14. * 2、添加视图解析器(可以添加多个)
  15. *
  16. * @param registry
  17. */
  18. @Override
  19. public void configureViewResolvers(ViewResolverRegistry registry) {
  20. InternalResourceViewResolver resolver = new InternalResourceViewResolver();
  21. resolver.setPrefix("/WEB-INF/view/");
  22. resolver.setSuffix(".jsp");
  23. resolver.setOrder(Ordered.LOWEST_PRECEDENCE);
  24. registry.viewResolver(resolver);
  25. }
  26. @Autowired
  27. private MyInterceptor myInterceptor;
  28. /**
  29. * 3、添加拦截器(可以添加多个)
  30. *
  31. * @param registry
  32. */
  33. @Override
  34. public void addInterceptors(InterceptorRegistry registry) {
  35. registry.addInterceptor(this.myInterceptor).addPathPatterns("/**");
  36. }
  37. /**
  38. * 4、配置静态资源访问处理器
  39. *
  40. * @param registry
  41. */
  42. @Override
  43. public void addResourceHandlers(ResourceHandlerRegistry registry) {
  44. registry.addResourceHandler("/static/**").addResourceLocations("/static/");
  45. }
  46. /**
  47. * 5、配置文件上传解析器
  48. *
  49. * @return
  50. */
  51. @Bean
  52. public CommonsMultipartResolver multipartResolver() {
  53. CommonsMultipartResolver commonsMultipartResolver = new CommonsMultipartResolver();
  54. //maxUploadSizePerFile:单个文件大小限制(byte)
  55. //maxUploadSize:整个请求大小限制(byte)
  56. commonsMultipartResolver.setMaxUploadSizePerFile(10 * 1024 * 1024);
  57. commonsMultipartResolver.setMaxUploadSize(100 * 1024 * 1024);
  58. return commonsMultipartResolver;
  59. }
  60. }

2、SpringMVC容器的生命周期(9个阶段)

  1. 阶段1:Servlet容器初始化
  2. 阶段2:创建父容器
  3. 阶段3:创建springmvc容器
  4. 阶段4:Servlet容器中注册DispatcherServlet
  5. 阶段5:启动父容器:ContextLoaderListener
  6. 阶段6:启动springmvc容器:DispatcherServlet#init()
  7. 阶段7:springmvc容器启动过程中处理@WebMVC
  8. 阶段8:组装DispatcherServlet中各种SpringMVC需要的组件
  9. 阶段9:销毁2个容器

3、阶段1:Servlet容器初始化

3.1、ServletContainerInitializer

咱们知道servlet3.0中新增了一个接口:ServletContainerInitializer,这个接口功能特别的牛逼,有了它之后,web.xml配置文件可要可不要了。

  1. public interface ServletContainerInitializer {
  2. public void onStartup(Set<Class<?>> c, ServletContext ctx)
  3. throws ServletException;
  4. }

这个接口的实现类,如果满足下面2个条件,Servlet容器启动的过程中会自动实例化这些类,然后调用他们的onStartUp方法,然后我们就可以在这些类的onStartUp方法中干活了,在web.xml干的所有事情,都可以在这个方法中干,特别强大:

  1. 这个类必须实现ServletContainerInitializer接口,且非抽象类
  2. 这个类的全类名必须要放在META-INF/services/javax.servlet.ServletContainerInitializer这个文件中

3.2、SpringServletContainerInitializer

下面重点来了,springmvc提供了一个类SpringServletContainerInitializer,满足了上面个条件。

spring-web-5.3.6.jar!\META-INF\services\javax.servlet.ServletContainerInitializer

所以SpringServletContainerInitializer的onStart方法会servlet容器自动被调用

3.3、SpringServletContainerInitializer#onStartup方法

这个类的源码,大家先看一下,这个类干的事情:

  1. 类上有@HandlesTypes(WebApplicationInitializer.class) 这个注解,注解的值为WebApplicationInitializer.class,所以onStartup方法的第一个参数是WebApplicationInitializer类型的集合,这个集合由web容器自动扫描获取,然后传入进来
  2. 实例化WebApplicationInitializer集合
  3. 对WebApplicationInitializer集合进行排序
  4. 循环调用WebApplicationInitializer的onStartup方法
  1. @HandlesTypes(WebApplicationInitializer.class) //@1
  2. public class SpringServletContainerInitializer implements ServletContainerInitializer {
  3. @Override
  4. public void onStartup(@Nullable Set<Class<?>> webAppInitializerClasses, ServletContext servletContext)
  5. throws ServletException {
  6. List<WebApplicationInitializer> initializers = Collections.emptyList();
  7. if (webAppInitializerClasses != null) {
  8. initializers = new ArrayList<>(webAppInitializerClasses.size());
  9. for (Class<?> waiClass : webAppInitializerClasses) {
  10. // Be defensive: Some servlet containers provide us with invalid classes,
  11. // no matter what @HandlesTypes says...
  12. if (!waiClass.isInterface() && !Modifier.isAbstract(waiClass.getModifiers()) &&
  13. WebApplicationInitializer.class.isAssignableFrom(waiClass)) {
  14. try {
  15. initializers.add((WebApplicationInitializer)
  16. ReflectionUtils.accessibleConstructor(waiClass).newInstance());
  17. }
  18. catch (Throwable ex) {
  19. throw new ServletException("Failed to instantiate WebApplicationInitializer class", ex);
  20. }
  21. }
  22. }
  23. }
  24. if (initializers.isEmpty()) {
  25. servletContext.log("No Spring WebApplicationInitializer types detected on classpath");
  26. return;
  27. }
  28. servletContext.log(initializers.size() + " Spring WebApplicationInitializers detected on classpath");
  29. AnnotationAwareOrderComparator.sort(initializers);
  30. for (WebApplicationInitializer initializer : initializers) {
  31. initializer.onStartup(servletContext);
  32. }
  33. }
  34. }

下面重点要看WebApplicationInitializer接口了。

3.4、WebApplicationInitializer:web应用初始化

接口比较简单,就一个方法,参数是servlet上下文对象,有了个对象,可以干web.xml中的一切事情了,比如注册servlet、filter、监听器等等

  1. public interface WebApplicationInitializer {
  2. void onStartup(ServletContext servletContext) throws ServletException;
  3. }

如下图,看一下类的继承关系,咱们的MvcInit就实现了这个接口,所以MvcInit的onStartup方法会被调费用

关键代码在这3个类中

3.5、进入AbstractDispatcherServletInitializer#onStartup方法

  1. public void onStartup(ServletContext servletContext) throws ServletException {
  2. super.onStartup(servletContext);
  3. registerDispatcherServlet(servletContext);
  4. }

这里是重点:这个方法中干了4件事情

  1. 创建父容器,只是实例化了,并未启动
  2. 创建了监听器ContextLoaderListener,这是一个ServletContextListener类型的监听器,稍后会在这个监听器中启动父容器
  3. 创建springmvc容器,只是实例化了,并未启动,启动的事情会在DispatcherServlet#init中做,稍后会说
  4. Servlet容器中注册DispatcherServlet

下面,咱们来详细看这几个步骤,把这几个步骤作为阶段来解读。

4、阶段2:创建父容器

父容器可有可无,并不是必须的,为了更好的管理bean,springmvc建议我们用父子容器,controller之外的bean,比如service,dao等,建议放到父容器中,controller层的和springmvc相关的一些bean放在springmvc容器中,咱们继续。

4.1、过程

AbstractDispatcherServletInitializer#onStartup方法中会调用父类的onStartup,即AbstractContextLoaderInitializer#onStartup,我们进到这个方法中,代码如下图,干了2个事情

  1. 图中编号①:创建父容器,只是实例化了,并未启动
  2. 图中编号②:创建了一个监听器ContextLoaderListener,这是一个ServletContextListener类型的监听器,稍后会在这个监听器中启动父容器

下面来分别来细说下上面2段代码干的活。

4.2、①:负责创建父容器

AbstractAnnotationConfigDispatcherServletInitializer#createRootApplicationContext,只是创建了一个AnnotationConfigWebApplicationContext对象,并将父容器配置类rootConfigClass注册到容器中,并没有启动这个容器,若rootConfigClass为空,父容器不会被创建,所以父容器可有可无。

4.2、②:创建ContextLoaderListener监听器

代码如下,创建的时候将父容器对象rootAContext传进去了。

  1. ContextLoaderListener listener = new ContextLoaderListener(rootAppContext);
  2. //getRootApplicationContextInitializers()返回置为ApplicationContextInitializer数组,是个函数式接口,在父容器初始化的过程中,会作为一个扩展点预留给开发者用
  3. listener.setContextInitializers(getRootApplicationContextInitializers());
  4. servletContext.addListener(listener);

ContextLoaderListener,这是一个ServletContextListener类型的监听器,所以在web容器启动和销毁的过程中会被调用,如下图,这个监听器干了2件事

  1. contextInitialized方法:这个方法会在web容器启动时被调用,内部负责启动父容器
  2. 在contextDestroyed方法:这个方法会在web容器销毁时被调用,内部负责关闭父容器

5、阶段3&4:创建springmvc容器&注册DispatcherServlet

在回到AbstractDispatcherServletInitializer#onStartup,看这个方法的第二行,如下图

registerDispatcherServlet源码如下

  1. protected void registerDispatcherServlet(ServletContext servletContext) {
  2. //①:DispatcherServlet的servlet名称,默认为:dispatcher
  3. String servletName = getServletName();
  4. //②:创建springmvc容器
  5. WebApplicationContext servletAppContext = createServletApplicationContext();
  6. //③:创建DispatcherServlet,注意这里将springmvc容器对象做为参数传递给DispatcherServlet了
  7. FrameworkServlet dispatcherServlet = createDispatcherServlet(servletAppContext);
  8. //设置ApplicationContextInitializer列表,可以对springmvc容器在启动之前进行定制化
  9. dispatcherServlet.setContextInitializers(getServletApplicationContextInitializers());
  10. //④:将 dispatcherServlet 注册到servlet上下文中
  11. ServletRegistration.Dynamic registration = servletContext.addServlet(servletName, dispatcherServlet);
  12. registration.setLoadOnStartup(1);
  13. registration.addMapping(getServletMappings());
  14. registration.setAsyncSupported(isAsyncSupported());
  15. //⑤:注册Filter
  16. Filter[] filters = getServletFilters();
  17. if (!ObjectUtils.isEmpty(filters)) {
  18. for (Filter filter : filters) {
  19. registerServletFilter(servletContext, filter);
  20. }
  21. }
  22. //⑥:这个方法预留给咱们自己去实现,可以对dispatcherServlet做一些特殊的配置
  23. customizeRegistration(registration);
  24. }
  25. protected FrameworkServlet createDispatcherServlet(WebApplicationContext servletAppContext) {
  26. return new DispatcherServlet(servletAppContext);
  27. }

6、阶段5:启动父容器:ContextLoaderListener

6.1、过程

上面的onStartup方法执行完毕之后,会执行监听器ContextLoaderListener的初始化,会进入到他的contextInitialized方法中

initWebApplicationContext源码如下,截取了主要的几行

  1. public WebApplicationContext initWebApplicationContext(ServletContext servletContext) {
  2. //this.context就是父容器对象
  3. ConfigurableWebApplicationContext cwac = (ConfigurableWebApplicationContext) this.context;
  4. //①:配置及启动父容器
  5. configureAndRefreshWebApplicationContext(cwac, servletContext);
  6. //将父容器丢到servletContext中进行共享,方便其他地方获取
  7. servletContext.setAttribute(WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE, this.context);
  8. }

6.2、代码①:配置父容器以及启动父容器

  1. //①:配置及启动父容器
  2. configureAndRefreshWebApplicationContext(cwac, servletContext);

configureAndRefreshWebApplicationContext方法关键代码如下

  1. protected void configureAndRefreshWebApplicationContext(ConfigurableWebApplicationContext wac, ServletContext sc) {
  2. //①:定制上线文,这里主要是遍历ApplicationContextInitializer列表,调用每个ApplicationContextInitializer#initialize方法来对容器进行定制,相当于一个扩展点,可以有程序员自己控制
  3. customizeContext(sc, wac);
  4. //②:刷新容器,就相当于启动容器了,此时就会组装里面的bean了
  5. wac.refresh();
  6. }

customizeContext方法,我们进去看一下,这里涉及到了一个新的类,所以有必要去看一下,混个脸熟,源码如下,这是给开发者留的一个扩展点,通过ApplicationContextInitializer这个来做扩展,这是一个函数式接口,下面代码会遍历ApplicationContextInitializer列表,然后调用其initialize方法,我们可以在这个方法中对spring上线文进行定制

  1. protected void customizeContext(ServletContext sc, ConfigurableWebApplicationContext wac) {
  2. List<Class<ApplicationContextInitializer<ConfigurableApplicationContext>>> initializerClasses =
  3. determineContextInitializerClasses(sc);
  4. for (Class<ApplicationContextInitializer<ConfigurableApplicationContext>> initializerClass : initializerClasses) {
  5. Class<?> initializerContextClass =
  6. GenericTypeResolver.resolveTypeArgument(initializerClass, ApplicationContextInitializer.class);
  7. if (initializerContextClass != null && !initializerContextClass.isInstance(wac)) {
  8. throw new ApplicationContextException(String.format(
  9. "Could not apply context initializer [%s] since its generic parameter [%s] " +
  10. "is not assignable from the type of application context used by this " +
  11. "context loader: [%s]", initializerClass.getName(), initializerContextClass.getName(),
  12. wac.getClass().getName()));
  13. }
  14. this.contextInitializers.add(BeanUtils.instantiateClass(initializerClass));
  15. }
  16. AnnotationAwareOrderComparator.sort(this.contextInitializers);
  17. for (ApplicationContextInitializer<ConfigurableApplicationContext> initializer : this.contextInitializers) {
  18. initializer.initialize(wac);
  19. }
  20. }

6.3、ApplicationContextInitializer接口:容器启动前用来初始化容器

是个函数式接口,在容器启动之前用来对容器进行定制,作为一个扩展点预留给开发者用,父容器和springmvc容器都用到了。

  1. @FunctionalInterface
  2. public interface ApplicationContextInitializer<C extends ConfigurableApplicationContext> {
  3. /**
  4. * 初始化给定的spring容器
  5. * @param applicationContext the application to configure
  6. */
  7. void initialize(C applicationContext);
  8. }

7、阶段6:启动springmvc容器:DispatcherServlet#init()

到目前为止父容器已经启动完毕了,此时DispatcherServlet会被初始化,会进入到他的init()方法中。

7.1、DispatcherServlet类图

7.2、HttpServletBean#init()

这个方法会调用initServletBean()这个方法,其他的先不看

7.3、FrameworkServlet#initServletBean

提取了关键的代码,就2行

  1. @Override
  2. protected final void initServletBean() throws ServletException {
  3. //初始化springmvc容器,就是启动springmvc容器
  4. this.webApplicationContext = initWebApplicationContext();
  5. //这个方法内部是空的,预留给子类去实现的,目前没啥用
  6. initFrameworkServlet();
  7. }

下面咱们进到initWebApplicationContext方法中去。

7.4、FrameworkServlet#initWebApplicationContext

关键代码如下,干了3件事情:

  1. 从servlet上线文对象中找到父容器
  2. 为springmvc容器指定父容器
  3. 调用configureAndRefreshWebApplicationContext方法配置springmvc容器以及启动容器,这个是关键咯
  1. protected WebApplicationContext initWebApplicationContext() {
  2. //①:从servlet上线文中获取父容器
  3. WebApplicationContext rootContext =
  4. WebApplicationContextUtils.getWebApplicationContext(getServletContext());
  5. WebApplicationContext wac = null;
  6. //②:this.webApplicationContext就是springmvc容器,此时这个对对象不为null,所以满足条件
  7. if (this.webApplicationContext != null) {
  8. wac = this.webApplicationContext;
  9. if (wac instanceof ConfigurableWebApplicationContext) {
  10. ConfigurableWebApplicationContext cwac = (ConfigurableWebApplicationContext) wac;
  11. //springmvc容器未启动
  12. if (!cwac.isActive()) {
  13. //springmvc容器未设置父容器,则给其设置父容器,此时rootContext可能为空,这个没什么关系
  14. if (cwac.getParent() == null) {
  15. cwac.setParent(rootContext);
  16. }
  17. //③:配置springmvc容器以及启动springmvc容器
  18. configureAndRefreshWebApplicationContext(cwac);
  19. }
  20. }
  21. }
  22. //这里省略了一部分代码,如果springmvc采用配置文件的方式会走这部分代码
  23. ......
  24. //返回容器
  25. return wac;
  26. }

7.5、FrameworkServlet#configureAndRefreshWebApplicationContext

为了让大家看清楚,如下代码,这里只提取了关键代码,主要干了3件事情

  1. 代码①:向springmvc容器中添加了一个ContextRefreshListener监听器,这个监听器非常非常重要,springmvc容器启动完毕之后会被调用,会出现在阶段8中
  2. 代码②:给开发者预留的一个扩展点,通过ApplicationContextInitializer#initialize方法对容器进行定制
  3. 代码③:启动容器
  1. protected void configureAndRefreshWebApplicationContext(ConfigurableWebApplicationContext wac) {
  2. //①:向springmvc容器中添加了一个监听器对象,这个监听器特别重要,稍后在
  3. wac.addApplicationListener(new SourceFilteringListener(wac, new ContextRefreshListener()));
  4. //②:扩展点:循环遍历ApplicationContextInitializer列表,调用其initialize方法对容器进行定制
  5. applyInitializers(wac);
  6. //③:刷新容器,相当于启动容器
  7. wac.refresh();
  8. }

8、阶段7:springmvc容器启动过程中处理@WebMVC

8.1、SpringMVC配置类被处理

此时springmvc容器启动了,此时注意下MvcConfig这个类,由于其上有@Conguration注解,所以会被当做一个配置类被处理,这个类有2个非常重要的特征。

  1. 标注了@EnableWebMvc注解
  2. 实现了WebMvcConfigurer接口

下面来说说这2个特征的作用。

8.2、@EnableWebMvc:配置springmvc所需组件

看一下这个注解的源码,如下,重点在于它上面的@Import(DelegatingWebMvcConfiguration.class)注解,这个注解的功能不知道的,可以回头去看我的spring系列,从头看一遍。

8.3、进入DelegatingWebMvcConfiguration类

代码如下,先注意下面3个特征

  1. 代码编号①:标注有@Configuration注解,说明是一个配置类
  2. 代码编号②:继承了WebMvcConfigurationSupport类,这个类中有很多@Bean标注的方法,用来定义了springmvc需要的所有组件
  3. 代码编号③:注入了WebMvcConfigurer列表,注意下,我们的WebConfig类就实现了WebMvcConfigurer这个接口,内部提供了很多方法可以用来对springmvc的组件进行自定义配置

先来看看WebMvcConfigurationSupport这个类。

8.4、WebMvcConfigurationSupport:配置springmvc所需所有组件

这个类中会定义springmvc需要的所有组件,比如:RequestMapping、HandlerAdapter、HandlerInterceptor、HttpMessageConverter、HandlerMethodArgumentResolver、HandlerMethodReturnValueHandler等等,所以如果你感觉@WebMVC注解满足不了你的需求时,你可以直接继承这个类进行扩展。

这个类的源码我就不贴了,截几个图给大家看看

8.5、WebMvcConfigurer接口

这个接口就是我们用来对springmvc容器中的组件进行定制的,WebMvcConfigurationSupport中创建springmvc组件的时候,会自动调用WebMvcConfigurer中对应的一些方法,来对组件进行定制,比如可以在WebMvcConfigurer中添加拦截器、配置默认servlet处理器、静态资源处理器等等,这个接口的源码如下

  1. public interface WebMvcConfigurer {
  2. /**
  3. * 配置PathMatchConfigurer
  4. */
  5. default void configurePathMatch(PathMatchConfigurer configurer) {
  6. }
  7. /**
  8. * 配置ContentNegotiationConfigurer
  9. */
  10. default void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
  11. }
  12. /**
  13. * 异步处理配置
  14. */
  15. default void configureAsyncSupport(AsyncSupportConfigurer configurer) {
  16. }
  17. /**
  18. * 配置默认servlet处理器
  19. */
  20. default void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
  21. }
  22. /**
  23. * 配置Formatter
  24. */
  25. default void addFormatters(FormatterRegistry registry) {
  26. }
  27. /**
  28. * 添加拦截器
  29. */
  30. default void addInterceptors(InterceptorRegistry registry) {
  31. }
  32. /**
  33. * 静态资源配置
  34. */
  35. default void addResourceHandlers(ResourceHandlerRegistry registry) {
  36. }
  37. /**
  38. * 跨越的配置
  39. */
  40. default void addCorsMappings(CorsRegistry registry) {
  41. }
  42. /**
  43. * 配置ViewController
  44. */
  45. default void addViewControllers(ViewControllerRegistry registry) {
  46. }
  47. /**
  48. * 注册视图解析器(ViewResolverRegistry)
  49. */
  50. default void configureViewResolvers(ViewResolverRegistry registry) {
  51. }
  52. /**
  53. * 注册处理器方法参数解析器(HandlerMethodArgumentResolver)
  54. */
  55. default void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
  56. }
  57. /**
  58. * 注册处理器方法返回值处理器(HandlerMethodReturnValueHandler)
  59. */
  60. default void addReturnValueHandlers(List<HandlerMethodReturnValueHandler> handlers) {
  61. }
  62. /**
  63. * 注册http报文转换器(HttpMessageConverter)
  64. */
  65. default void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
  66. }
  67. /**
  68. * 扩展报文转换器
  69. */
  70. default void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
  71. }
  72. /**
  73. * 配置异常解析器(HandlerExceptionResolver)
  74. */
  75. default void configureHandlerExceptionResolvers(List<HandlerExceptionResolver> resolvers) {
  76. }
  77. /**
  78. * 扩展异常解析器(HandlerExceptionResolver)
  79. */
  80. default void extendHandlerExceptionResolvers(List<HandlerExceptionResolver> resolvers) {
  81. }
  82. /**
  83. * 获得验证器
  84. */
  85. @Nullable
  86. default Validator getValidator() {
  87. return null;
  88. }
  89. /**
  90. * 获得MessageCodesResolver
  91. */
  92. @Nullable
  93. default MessageCodesResolver getMessageCodesResolver() {
  94. return null;
  95. }
  96. }

9、阶段8:组装DispatcherServlet中各种SpringMVC需要的组件

9.1、触发ContextRefreshListener监听器

大家回头看一下8.5中,有这样一段代码,注册了一个监听器ContextRefreshListener

再来看看这个监听器的源码,如下图,包含2点信息

  1. 会监听ContextRefreshedEvent事件
  2. 监听到事件之后将执行FrameworkServlet.this.onApplicationEvent(event);,稍后会具体说这个代码

如下代码,springmvc容器启动完毕之后,会发布一个ContextRefreshedEvent事件,会触发上面这个监听器的执行

9.2、进入FrameworkServlet.this.onApplicationEvent(event);

  1. public void onApplicationEvent(ContextRefreshedEvent event) {
  2. //标记已收到刷新事件
  3. this.refreshEventReceived = true;
  4. synchronized (this.onRefreshMonitor) {
  5. onRefresh(event.getApplicationContext());
  6. }
  7. }

上面的onRefresh(event.getApplicationContext());会进到DispatcherServlet#onRefresh方法中。

9.3、进入DispatcherServlet#onRefresh

  1. protected void onRefresh(ApplicationContext context) {
  2. initStrategies(context);
  3. }

里面会调用initStrategies方法。

9.4、DispatcherServlet#initStrategies:初始化DispatcherServlet中的组件

代码如下,这里面会初始化DispatcherServlet中的各种组件,这里的所有方法初始化的过程基本上差不多,就是先从springmvc容器中找这个组件,如果找不到一般会有一个兜底的方案

  1. protected void initStrategies(ApplicationContext context) {
  2. //初始化MultipartResolver
  3. initMultipartResolver(context);
  4. //初始化LocaleResolver
  5. initLocaleResolver(context);
  6. //初始化ThemeResolver
  7. initThemeResolver(context);
  8. //初始化HandlerMappings
  9. initHandlerMappings(context);
  10. //初始化HandlerAdapters
  11. initHandlerAdapters(context);
  12. //初始化HandlerExceptionResolvers
  13. initHandlerExceptionResolvers(context);
  14. //初始化RequestToViewNameTranslator
  15. initRequestToViewNameTranslator(context);
  16. //初始化视图解析器ViewResolvers
  17. initViewResolvers(context);
  18. //初始化FlashMapManager
  19. initFlashMapManager(context);
  20. }

下面我们以initHandlerMappings(context);为例来看一下是如何初始化这些组件的。

9.5、initHandlerMappings(context);

源码如下,就是先从容器中找,找不到走兜底的方案。

  1. private void initHandlerMappings(ApplicationContext context) {
  2. this.handlerMappings = null;
  3. //是否需要查找所有的HandlerMapping,默认为true
  4. if (this.detectAllHandlerMappings) {
  5. //从容器中查找所有的HandlerMapping
  6. Map<String, HandlerMapping> matchingBeans =
  7. BeanFactoryUtils.beansOfTypeIncludingAncestors(context, HandlerMapping.class, true, false);
  8. //对HandlerMapping列表进行排序
  9. if (!matchingBeans.isEmpty()) {
  10. this.handlerMappings = new ArrayList<>(matchingBeans.values());
  11. AnnotationAwareOrderComparator.sort(this.handlerMappings);
  12. }
  13. }
  14. else {
  15. try {
  16. //查找名称为handlerMapping的HandlerMapping
  17. HandlerMapping hm = context.getBean("handlerMapping", HandlerMapping.class);
  18. this.handlerMappings = Collections.singletonList(hm);
  19. }
  20. catch (NoSuchBeanDefinitionException ex) {
  21. }
  22. }
  23. // 如果没有找到HandlerMapping,则走兜底的方案
  24. if (this.handlerMappings == null) {
  25. this.handlerMappings = getDefaultStrategies(context, HandlerMapping.class);
  26. }
  27. }

下面我们来看一下兜底的代码如何走的,进入getDefaultStrategies方法

9.6、DispatcherServlet#getDefaultStrategies:兜底的方案查找组件

这个方法的源码就不贴出来了,这里只说一下兜底的处理过程,springmvc有个配置文件:spring-webmvc-5.3.6.jar!\org\springframework\web\servlet\DispatcherServlet.properties,properties格式的文件,key为组件的完整类名,value为多个实现类的列表,在这个配置文件中指定了每种类型的组件兜底的情况下对应的实现类,比如没有找到RequestMapping的情况下,如下图红框的部分,有3个兜底的实现类,然后springmvc会实例化这3个类作为RequestMapping。

10、阶段9:销毁容器

10.1、销毁springmvc容器:DispatcherServlet#destroy

DispatcherServlet销毁的时候会关闭springmvc容器

  1. public void destroy() {
  2. if (this.webApplicationContext instanceof ConfigurableApplicationContext && !this.webApplicationContextInjected) {
  3. ((ConfigurableApplicationContext) this.webApplicationContext).close();
  4. }
  5. }

10.2、销毁父容器:ContextLoaderListener#contextDestroyed

父容器是在监听器中启动的,所以销毁的也是监听器负责的

  1. public void contextDestroyed(ServletContextEvent event) {
  2. closeWebApplicationContext(event.getServletContext());
  3. ContextCleanupListener.cleanupAttributes(event.getServletContext());
  4. }

springmvc容器的生命周期到此就结束了,想掌握好这个过程,建议大家debug走几遍,就熟悉了,下面带大家debug一下代码。

11、带大家debug代码

11.1、拉取源码

  1. https://gitee.com/javacode2018/springmvc-series

11.2、将下面这个模块发布到tomcat

11.2、按照下面配置设置断点,启动,调试代码

依次在下面这些方法中设置断点,然后启动tomcat,一步步调试,我相信你们肯定可以吃透的。

  1. 1org.springframework.web.SpringServletContainerInitializer#onStartup:入口
  2. 2org.springframework.web.servlet.support.AbstractDispatcherServletInitializer#onStartup
  3. 3org.springframework.web.context.AbstractContextLoaderInitializer#onStartup
  4. 4org.springframework.web.context.AbstractContextLoaderInitializer#registerContextLoaderListener:创建父容器
  5. 5org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer#createRootApplicationContext
  6. 6org.springframework.web.servlet.support.AbstractDispatcherServletInitializer#registerDispatcherServlet
  7. 7org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer#createServletApplicationContext:创建springmvc容器 & 注册DispatcherServlet
  8. 8org.springframework.web.context.ContextLoaderListener#contextInitialized
  9. 9org.springframework.web.context.ContextLoader#initWebApplicationContext
  10. 10org.springframework.web.context.ContextLoader#configureAndRefreshWebApplicationContext:启动父容器
  11. 11org.springframework.web.servlet.HttpServletBean#init
  12. 12org.springframework.web.servlet.FrameworkServlet#initServletBean
  13. 13org.springframework.web.servlet.FrameworkServlet#initWebApplicationContext:初始化springmvc容器&启动springmvc容器
  14. 14org.springframework.web.servlet.FrameworkServlet#configureAndRefreshWebApplicationContext:启动springmvc容器
  15. 15org.springframework.web.servlet.FrameworkServlet.ContextRefreshListener#onApplicationEvent
  16. 16org.springframework.web.servlet.DispatcherServlet#onRefresh
  17. 17org.springframework.web.servlet.DispatcherServlet#initStrategies:组装Dispathcer中各种springmvc组件

有问题欢迎加我微信:itsoku,交流。

最新资料

更多内容请访问:IT源点

相关文章推荐

全部评论: 0

    我有话说: