StandardContext

        一个上下文容器（Context）代表一个web应用，每一个上下文包括多个包装器（Wrapper），每个包装器代表一个Servlet。但是，上下文还需要其它的一些组件如加载器和管理器。本章要介绍Catalina中Context接口的标准实现，org.apache.catalina.core.StandardContext类。 我们首先介绍StandardContext对象的初始化和配置，然后讨论跟其相关的类StandardContextMapper（Tomcat 4）和ContextConfig类。接下来看，当容器接受到HTTP请求的时候方法调用顺序。

   StandardContext配置

        创建一个StandardContext实例之后，必须调用它的start方法，这样它就能为受到的HTTP请求服务了。一个StandardContext对象可能启动失败，这时候属性available被设置为false，属性available表示了StandardContext对象的可用性。 如果start方法启动成功，StandardContext对象需要配置它的属性。在一个Tomcat部署中，StandardContext的配置过程做了以下事情：

    1、准备读取和解析%CATALINA_HOME%/conf 目录下面的web.xml，部署所有应用程序，确保StandardContext实例可以处理应用级别的web.xml

    2、配置需要添加一个验证器阀门和证书阀门（authenticator valve and a certificate valve）

        StandardContext的属性之一是它属性configured,用来表示该StandardContext是否已经配置了。StandardContext使用一个事件监听器来作为它的配置器。当StandardContext实例的start方法被调用的时候，首先触发一个生命周期事件。该事件唤醒一个监听器来配置该StandardContext实例。配置成功后，该监听器将configured属性设置为true。否则，StandardContext对象拒绝启动，这样就不能对HTTP请求进行服务了。

    上面看到一个生命周期监听器被添加到StandardContext实例上，它的类型是SimpleContextConfig，它仅仅将StandardContext实例的configured属性设置为true，这样就认为配置完成了。在一个Tomcat部署中，配置StandardContext的生命周期监听器类型为org.apache.catalina.startup.ContextConfig。

StandardContext构造函数

       

    在构造函数中，最重要的事情是在StandardContext的流水线上添加了一个类型为org.apache.catalina.core.StandardContextValve的基本阀门，该阀门用于转发连接器获得的HTTP请求。

 启动StandardContext

    start方法初始化StandardContext对象并让生命周期监听器配置该StandardContext实例。如果配置成功，生命周期监听器会将configured属性设置为true。最后start方法，将available属性设置为true或者false。如果是true的话表示该StandardContext属性配置完毕并且所有相关子容器和组件已经成功启动，这样就能对HTTP请求进行服务了，如果是false则表示出现了错误。

    StandardContext类将configured的值初始化为false，如果生命周期监听器的配置过程成功，则将该值设置为true。在start方法的最后，它检查StandardContext对象的configured属性，如果该值为true，则启动该StandardContext成，否则调用stop方法停止所有已经启动的组件。

    

    

    

    

    

    

    

    

    

    

1、触发BEFORE_START事件

2、设置availability属性为false

3、设置configured属性为false

4、设置源（resources）

5、设置加载器

6、设置管理器

7、初始化属性map

8、启动跟该上下文相关的组件

9、启动子容器（包装器）

10、启动流水线

11、启动管理器

12、触发START事件。监听器（ContextConfig）会进行一系列配置操作，配置成功后，将StandardContext实例的configured属性设置为true。

13、检查configured属性的值，如果为true：调用postWelcomPages方法，加载子包装器，并将available属性设置为true。如果configured属性为false调用stop方法

14、触发AFTER_START事件

Invoke方法

    StandardContext的invoke方法由相关联的连接器调用，如果该上下文是一个主机（host）的子容器，有该主机的invoke方法调用。StandardContext的invoke方法首先检查是否正在重加载该应用程序，是的话，等待直到加载完毕。然后调用它的父类ContainerBase的invoke方法

    

    方法getPaused获得属性paused的值，当应用程序正在加载的时候该属性为ture。

StandardContextMapper

        对于每一个请求，invoke方法都会调用StandarContext流水线基本阀门的invoke方法。StandarContext的基本阀门用org.apache.catalina.core.StandardContextValve类表示。StandardContextValve的invoke方法需要得到一个处理请求的包装器。

        在Tomcat4中，StandardContextValve实例查找包含它的StandardContext。StandardContextValve使用上下文容器的map来查找合适的包装器。一旦它得到一个合适的包装器，调用该包装器的invoke方法。在介绍StandardContextValve的做法的时候，本节先介绍该map组件。

    StandardContext的父类ContainerBase定义了addDefaultMapper方法来添加一个默认的映射（map）如下

    

    StandardContext在start方法中调用它的addDefaultMapper方法，传递一个mapperClass变量。

    

    StandardContext的mapperClass变量定义如下： 

        private String mapperClass = "org.apache.catalina.core.StandardContextMapper";

    必须使用映射器的setContainer方法来讲映射跟容器相关联。org.apache.catalina.Mapper接口的标准实现是StandardContextMapper。。StandardContextMapper只能跟上下文相关联，使用的方法是setCOntainer

    

    在一个映射器（mapper）中最重要的方法是map方法，它获得一个HTTP请求返回一个子容器，该方法的签名如下：

            public Container map(Request request, boolean update)

    在StandardContextMapper中map方法返回一个包装器来处理请求。如果找不到合适的包装器，方法返回null。

    回到本节开始讨论的内容，StandardContextValve调用上下文容器的map方法来处理HTTP请求，传递的参数是org.apache.catalina.Request对象。map方法（ContainerBase类中）返回一个对应相应协议的映射器，然后调用该映射器的map方法。

       

        

    

    

    

    

    上下文容器时如何获得Servlet映射的，回头看第十一章中的Bootstrap类，它添加了两个Servlet映射到StandarContext。     context.addServletMapping("/Primitive", "Primitive"); 

 context.addServletMapping("/Modern", "Modern"); 

它还将包装器作为子容器添加到上下文容器中。

     context.addChild(wrapper1); context.addChild(wrapper2);

Tomcat 5删除了Mapper接口及其相关类。实际上StandardContextValve的invoke方法就能得到请求的合适包装器。 

    Wrapper wrapper = request.getWrapper(); 这表示映射信息已经包装在请求对象中了。

重加载支持

        StandardContext定义了reloadable属性来标识是否支持应用程序的重加载。当允许重加载的时候，当web.xml或者WEB-INF/classes目录下的文件被改变的时候会重加载。 StandardContext用它的加载器来加载应用程序。在Tomcat4中，StandardContext 中Loader接口的标准实现WebappLoader类，有一个单独线程来检查WEB-INF目录下面所有类和JAR文件的时间戳。你需要做的是启动该线程，将 WebappLoader关联到StandardContext，使用setContainer方法即可。下面是Tomcat4中WebappLoader的实现：

    

    注意最后一个if语句块中，如果容器是一个上下文容器，调用setReloadable方法，也就是说WebappLoader的reloadable属性跟StandardContext的reloadable属性相同。

    

    如果将reloadable属性设置为true，调用threadStart方法。如果从true到false，则调用threadStop方法。threadStart方法启动一个线程持续的检查WEB-INF目录下面的类文件和JAR文件的时间戳。threadStop方法用于停止该线程。

 backgroundProcess方法

    一个上下文容器需要其它组件如加载器和管理器的支持。这些组件通常需要一个单独的线程来处理后台过程（background processing）。例如，加载器通过一个线程检查类文件和JAR文件的时间戳来支持自动重载。管理器需要一个线程来检查它管理的Session对象过期时间。在Tomcat4中，这些组件都有自己的线程。 为了节省资源，Tomcat使用了一种不同的方式来处理。所有的后台过程都分享同一个线程。如果一个组件或者是容器需要定期的来执行操作，它需要做的是将这些代码写入到backgroundProcess方法即可。

    共享线程有ContainerBase对象创建，ContainerBase在他的start方法中调用threadStard方法

    

    方法threadStart传递一个ContainerBackgroundProcessor对象创建一个新线程。ContainerBackgroundProcessor实现了java.lang.Runnable接口

    

    

    ContainerBackgroundProcessor是ContainerBase的内部类，在他的run方法里，有一个while循环定期的调用它的processChildren方法。processChildren调用backgroundProcess来处理它的每个孩子的processChildren方法。要实现backgroundProcess方法，以ContainerBase的子类可以有一个线程来周期性的执行任务，例如检查时间戳或者Session对象的终结时间。StandardContext的backgroundProcess方法的实现。