How tomcat works 读书笔记十五 Digester库 下

在这一节里我们说说ContextConfig这个类。
这个类在很早的时候我们就已经使用了(之前那个叫SimpleContextConfig),但是在之前它干的事情都很简单,就是吧context里的configured变量置为true。在这里我们看看完整版的ContextConfig都干了什么。
在tomcat的实际部署中,StandContext类的实际监听器是org.apache.catalina.startup.ContextConfig的实例。
ContextConfig完成加载验证器阀,许可阀到StandContext的管道阀中。但最重要的就是应用上一节的Digester库,解析两个xml文件。一个是整个tomcat的配置文件,web.xml,在conf目录下。另一个是单个web应用的xml文件,在WEB-INF目录下。

在这里我主要说说如何让系统根据我们在某个web应用下的web.xml里面指定的那样,自动创建StandWrapper。

    LifecycleListener listener = new ContextConfig();
    ((Lifecycle) context).addLifecycleListener(listener);

  首先得在StandContext里注入ContextConfig这个监听器。

在StandContext的启动与关闭中,会触发以下的事件:
START_ENENT
STOP_ENENT

ContextConfig.java
 public void lifecycleEvent(LifecycleEvent event) {
        ...
        // Process the event that has occurred
        if (event.getType().equals(Lifecycle.START_EVENT))
            start();
        else if (event.getType().equals(Lifecycle.STOP_EVENT))
            stop();
    }

我们看看ContextConfig的start方法。

 private synchronized void start() {
    ...
        // Process the default and application web.xml files
        defaultConfig();          //解析conf/xml.xml
        applicationConfig();      //解析WEB-INF/web.xml
    ...
}

我们先不管整个tomcat的xml就看单个项目的:

 private void applicationConfig() {

       ...
        // Process the application web.xml file
        synchronized (webDigester) {
        //public static final String ApplicationWebXml = "/WEB-INF/web.xml";
                URL url =servletContext.getResource(Constants.ApplicationWebXml);

                InputSource is = new InputSource(url.toExternalForm());
                is.setByteStream(stream);
                webDigester.setDebug(getDebug());
                if (context instanceof StandardContext) {
                    ((StandardContext) context).setReplaceWelcomeFiles(true);
                }
                webDigester.clear();
                webDigester.push(context);//此时的栈里面就有context了
                webDigester.parse(is);  //开始解析
            }
    ...
    }

现在的问题是,那webDigester是怎么来的?
在ContextConfig中有下面的一个类变量。
private static Digester webDigester = createWebDigester();
我们看看createWebDigester

    private static Digester createWebDigester() {
        ...
        Digester webDigester = new Digester();
    ...
        webDigester.addRuleSet(new WebRuleSet());  //addRuleSet 对这个不清楚的看上一节
        return (webDigester);
    }

 现在我们就要去看WebRuleSet类了,还记得主要看哪个方法吗?

WebRuleSet.java
 public void addRuleInstances(Digester digester) {
    ....
         digester.addRule(prefix + "web-app/servlet",new WrapperCreateRule(digester));
    ...
    digester.addCallMethod(prefix + "web-app/servlet/servlet-class",
                              "setServletClass", 0);
        digester.addCallMethod(prefix + "web-app/servlet/servlet-name",
                              "setName", 0);
        digester.addCallMethod(prefix + "web-app/servlet-mapping",
                               "addServletMapping", 2);

    //setServletClass这个方法最后在哪里调用的? 请大家自己想一想
}

final class WrapperCreateRule extends Rule {

    public void begin(Attributes attributes) throws Exception {
        Context context =(Context) digester.peek(digester.getCount() - 1);
        Wrapper wrapper = context.createWrapper();
        digester.push(wrapper);
        if (digester.getDebug() > 0)
            digester.log("new " + wrapper.getClass().getName());
    }
}

大家看出流程了吗?
首先加入一个规则
digester.addRule(prefix + "web-app/servlet",new WrapperCreateRule(digester));
碰到web-app/servlet就调用begin方法,产生了一个wrapper。

web-app/servlet/servlet-name 碰到这个后,调用wrapper的那个方法就ok。