一个基于注解配置的Web项目的启动流程分析

最新推荐文章于 2023-06-28 15:45:01 发布

拾荒丶

最新推荐文章于 2023-06-28 15:45:01 发布

阅读量537

点赞数

分类专栏： Tomcat 文章标签： tomcat

Tomcat 专栏收录该内容

12 篇文章 0 订阅

订阅专栏

本文设计大量源码和Tomcat的一些实现。如果对这些没有兴趣，可以直接看最后的[总结]

通过注解配置一个Web应用

下面是一个通过注解实现一个简单的Web应用.


    public class SpringWebInitializer extend   AbstractAnnotationConfigDispatcherServletInitializer {
        @Override
        protected Class<?>[] getRootConfigClasses() {
            return new Class<?>[]{RootConfig.class};
        }
    
        @Override
        protected Class<?>[] getServletConfigClasses() {
            return new Class<?>[]{WebConfig.class};
        }
    
        @Override
        protected String[] getServletMappings() {
            return new String[]{"/"};
        }
    }

AbstractAnnotationConfigDispatcherServletInitializer的继承图

上面四个类，各有各的职责，相对于些.xml文件，你只需要实现这些抽象类的抽象方法即可。详细解释这里省略。

我们现在关注最顶层的那个接口 WebApplicaitonInitializer。经过查看其源码。

  public interface WebApplicationInitializer {

    /**
     * Configure the given {@link ServletContext} with any servlets, filters, listeners
     * context-params and attributes necessary for initializing this web application. See
     * examples {@linkplain WebApplicationInitializer above}.
     * @param servletContext the {@code ServletContext} to initialize
     * @throws ServletException if any call against the given {@code ServletContext}
     * throws a {@code ServletException}
     */
    void onStartup(ServletContext servletContext) throws ServletException;

}

什么都没发现。但是，通过同包下面的另一个接口 SpringServletContainerInitializer ,查看其源码。发现了它和WebApplicationInitializer扯上了关系，当时它实现的接口ServletContainerInitializer 和@HandlesTypes 注解的作用是什么？

@HandlesTypes(WebApplicationInitializer.class)
public class SpringServletContainerInitializer implements ServletContainerInitializer {


    @Override
    public void onStartup(Set<Class<?>> webAppInitializerClasses, ServletContext servletContext)
            throws ServletException {

        .......篇幅有限,去除无用代码.......

        for (WebApplicationInitializer initializer : initializers) {  // 通知启动WebApplicationInitializer 的实现
                      
            initializer.onStartup(servletContext);
        }
    }

}

SpringServletContainerInitilizer的类图

main函数在哪里？

我们知道，一个Java应用是需要一个main函数的作为入口来执行。但是我们平时写Web项目好像没有写过main函数。你可能有疑问，那它是怎么跑起来的？是不是用了什么特别的黑科技，没有用main函数？其实不是这样的，我们写web项目，少不了一个Web的应用容器，例如Tomcat， JBoss等等。main函数其实是在这些容器里面。

例如Tomcat,它的主类叫做Bootstrap，main函数就写在这个主类里面.

如果有兴趣可以下载下来Tomcat源码，导入到IDE中查看。参考这篇文章配置

你也可以直接pull 我在Github上已经配置好的源码，直接导入到Idea即可

在Tomcat应用服务器启动以后。它会通过反射，利用ClassLoader来加载Web-App文件夹下面的Web应用的jar包。

Tomcat加载Web应用？

我们知道，每个Web应用都有一个自己唯一的一个ServletContext，在Tomcat里面，SerlvetContext的实现类是ApplicationContext。看名字也可以知道这代表着一个Application应用的上下文环境。我们现在只关心这个类就可以了。这个类里面有个类型为StandardContext,这是Context标准实现。

说到这个类，然后我们就需要谈起一个接口ServletContextListener，这个接口用来提供一个观察者模式，简单的讲就是用来监控ServletContext的启动，销毁生命周期的。

看一下Tomcat所有容器的抽象类里面的ContainerMBean类里面的addChild方法，这个StandardContextx其实就是一个ServletContext，即为一个应用容器。

    //为容器添加子容器
  public void addChild(String type, String name) throws MBeanException{

        Container contained = (Container) newInstance(type);
        contained.setName(name);

        if(contained instanceof StandardHost){
            HostConfig config = new HostConfig();
            contained.addLifecycleListener(config);
        } else if(contained instanceof StandardContext){
            //添加的容器是一个Tomcat子容器的话，就分配其一个ContextCofig
            ContextConfig config = new ContextConfig();
            //将ContextConfig添加到Container的监听者行列中
            contained.addLifecycleListener(config);
        }

        boolean oldValue= true;

        ContainerBase container = doGetManagedResource();
        try {
            oldValue = container.getStartChildren();
            container.setStartChildren(false);
            container.addChild(contained);
            /*
                开始一个初始化，会通知所有正在监听Container的观察者
                对于ContextConfig来说，现在应该做的是加载配置等
            */
            contained.init();
        } catch (LifecycleException e){
            throw new MBeanException(e);
        } finally {
            if(container != null) {
                container.setStartChildren(oldValue);
            }
        }
    }

Tomcat 在为Host容器添加Context子容器时，会为其分配一个CntextConfig类。当你看到这个类名应该就会想到，这应该是和Web配置加载有关的一个类。

    @Override
    public void lifecycleEvent(LifecycleEvent event) {

        ......省略无用代码......
        // Process the event that has occurred
        if (event.getType().equals(Lifecycle.CONFIGURE_START_EVENT)) {
            //当监听的容器发送，CONFIGURE_START_EVENT时，配置开始
            configureStart();
        } 
        .....省略无用代码.......
    }

再来看看configureStart()方法

protected synchronized void configureStart() {
        
        ....省略无用代码·····     
    
        webConfig();

        if (!context.getIgnoreAnnotations()) {
            applicationAnnotationsConfig();
        }
        ·····省略无用代码·····
}

从代码中可以看到，Tomcat先是从调用WebConfig()函数.这个函数的主要的动作就是读取web.xml配置文件，

函数webConfig()的执行动作的流程

读取web-fragment.xml和各个jar模块
排序所有读取到的fragments

查找所有的ServletContainerInitializer(SCIs)
处理WEB-INF/Classes文件夹下面的
处理所有的注解配置类和，并缓存
将所有的web-fragment.xml合并
转换所有的JSP代码成Java代码
将Web.xml配置转变成代码式的配置
查找静态资源默认文件夹 WEB-INF/classes/META-INF/resources
将所有的实现ServletContainerInitializers的类添加到StandardContext的initializers集合中

我们在这里重点关注第三步和第十三步，webConfig()中会调用processServletContainerInitializers()这个方法即为加载所有的经过 @HandlesTypes注解的类。


   protected void webConfig() {

        ....

        // Step 3. 查找ServletContainerInitializers
        if (ok) {
            processServletContainerInitializers();
        }


       ......

        // Step 11. ServletContainerInitializer 交给StandardContext去处理！在这里即为我们的应用所在的容器
        if (ok) {
            for (Map.Entry<ServletContainerInitializer,
                    Set<Class<?>>> entry :
                        initializerClassMap.entrySet()) {
                if (entry.getValue().isEmpty()) {
                    context.addServletContainerInitializer(
                            entry.getKey(), null);
                } else {
                    context.addServletContainerInitializer(
                            entry.getKey(), entry.getValue());
                }
            }
        }
    }

我们去StandardContext里面去看一下它是怎么处理这个集合属性的。在StandardContext类里面的startInternel()方法，就是启动这个


    @Override
    protected synchronized void startInternal() throws LifecycleException {
            ....
            // Call ServletContainerInitializers,启动这些
            for (Map.Entry<ServletContainerInitializer, Set<Class<?>>> entry :
                initializers.entrySet()) {
                try {
          //启动所有的ServletContainerInitializer
                    entry.getKey().onStartup(entry.getValue(),
                            getServletContext());
                } catch (ServletException e) {
                    log.error(sm.getString("standardContext.sciFail"), e);
                    ok = false;
                    break;
                }
            }
            ...
    }

即: 通过内部启动时，它会通知所有正在监听的 ServletContainerInitializers,这样，即完成了Web应用的加载和初始化的配置！

总结

Tomcat的Host容器在添加子容器时，会通过解析.xml并通过classloader加载 @HandlesTypes注解的类
读取@HandlesTypes注解value值。并放入ServletContainerInitializers 对应的Set集合中
在ApplicationContext 内部启动时会通知 ServletContainerInitializers 的onStart方法()。这个onStart方法的第一个参数就是@HandlesTypes注解的value 值指定的Class集合
在Spring 应用中，对ServletContainerInitializers的实现就是SpringServletContainerInitializer,注解指定的类就是WebApplicationInitializer.

作者：walker_liu_fei
链接：https://www.jianshu.com/p/38f48c535988
來源：简书
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。