Tomcat研究之组件结构

时间:2022-09-18 16:15:15

Tomcat研究之组件结构

 

 

大家好,上篇介绍了《Tomcat研究之ClassLoader》,这篇我们介绍组件结构

     在没有任何实质性资料的前提下研究Tomcat的内核将是非常困难的事情,但无论如何还有opensource,我们至少可以跟踪Tomcat成百上千的类,为了我们能彻底解开Tomcat的面纱,我们还是要继续努力.

   通过UML类图不难看出,Core包里面最重要的一个类是ContainerBase,而这个抽象类实现了Container, Lifecycle, Pipeline, MBeanRegistration, Serializable接口, Serializable接口大家都已很熟悉,我们重在研究前几个接口,因为我们猜想整个Tomcat的部分构架可能是建立在这几个基础接口上.

    在进入分析之前我们先回忆一下config.xml(server.xml)文件,从这个文件及apache的文档我们大体可以了解到Tomcat宏观上是有下面几个部分组成:

-          Server  server元素是JVM的入口点,整个配置文件只有一个,因为server不是容器(container),因此不能嵌套子组件.server在某一指定的端口监听shutdown命令.server可以包含一个或多个service实。

-          Service service有共享同一个Container的一个或多个Connectors组成,一般Service就是一个Engine,但没有明确规范要求如此.因为Service不是一个Container,因此不能在里面嵌套子组件(比如Loggers/Valves)

-          Connector connector就是一个Tomcat与客户端的连接,Tomcat有两种典型的Connector:http,JK2.http connector监听来自Browser的连接(通常在我们熟悉的8080端口),JK2.来自其他WebServer的请求(默认在8009端口监听)Connector会把获得的请求交给Engine处理。

-          Engine Engine下可以配置多个虚主机Virtual Host个虚主机都有一个域名
Engine得一个,它把该请求匹配到某个Host上,然后把该请求交给该Host
Engine
有一个默主机,当求无法匹配到任何一个Host上的候,将交给该Host

-          Host host代表一个虚拟主机,默认是localhosthost下可以部署多个web application,在我们实际应用中一般要考虑问题的对象就是host

 

 

1.         org.apache.catalina.Lifecycle

通用的组件声明周期接口,一般Tomcat的组件都要实现这个接口(但不是必须的),这个接口是为所有组件提供相同的startstop。主要方法有:

//增加一个监听器

public void addLifecycleListener(LifecycleListener listener);

 

 

/**

*这个方法应该在任何public方法被调用前被调用

*该方法发送一个START_EVENT事件到所有注册到

*该组件的监听器

*/

public void start() throws LifecycleException;

 

 

/**

*这个方法应该在所有public方法被调用之后被调用

*该方法发送一个STOP_EVENT事件到所有注册到

*该组件的监听器

*/

public void stop() throws LifecycleException;

 

 

2.         org.apache.catalina. LifecycleListener

该接口用于监听一些重要事件(包括实现了Lifecycle接口组件产生的startstop事件)

主要方法是:

//处理监听到的事件

public void lifecycleEvent(LifecycleEvent event);

 

 

 

 

3.         org.apache.catalina.Container

容器是用于从客户端取得请求(request)并且处理请求并回复给客户端(response)的对象。容器可以支持(可选)pipeline,以便能在运行时按配置的顺序处理请求。

Tomcat里面,容器在概念上存在以下及层:

Engine    请求处理入口点,可以包含多个HostContext

Host        代表一个虚拟主机

Context        代表单个ServletContext,可以包含多个Wrappers

Wrapper  代表单个Servlet,如果Servlet实现了SingleThreadModel,可以代表单个Servlet的多个实例。

容器为了实现自己的功能经常要绑定一些其他组件,这些组件的功能可能被共享,也可以被单独定制,下面是被使用的组件:

Loader       ClassLoader,装载Java Classes

Logger       实现了ServletContextlog方法,用于记录日志

Manager         管理与容器绑定的session

Realm        用户安全管理

Resources  JNDI资源访问

主要的方法:

 

 

//增加容器监听器

public void addContainerListener(ContainerListener listener);

 

 

//增加property监听器

public void addPropertyChangeListener(PropertyChangeListener listener);

 

 

/**

*处理Request,并产生相应地Response

*param request 处理的请求

*param  response 产生的response

*/

public void invoke(Request request, Response response)   throws IOException, ServletException;

 

 

4.         org.apache.catalina. ContainerListener

容器事件监听器,注意的是startstop是正常的生命周期事件(LiftcycleEvent)不是容器事件。主要方法:

 

 

//处理容器事件

public void containerEvent(ContainerEvent event);

5.         org.apache.catalina. Pipeline

PiplelineValve的集合,当invoke方法被调用时,它会按指定的顺序调用Valve,它总是要求有一个Valve必须处理传递的request(一般是最后一个)并产生response,否则就把request传递到下一个Valve

  一般一个容器仅绑定一个Pipleline实例,一般说来容器会把处理request的功能封装到一个容器绑定的Valve里(这个Valve应该在Pipleline最后被执行)。为了完成这个功能,Pipleline提供了setBasic()方法以保证Valve被最后执行,而其他Valve按顺序被调用。

6.         org.apache.catalina.Valve

     Valve是被绑定在一个Container上的请求处理组件,一组Valve被按顺序绑定在一个Pipleline上。Valve最重要的一个方法是:


 

 

/**

 *一个Valve可能按照一定的顺序执行下面的动作

 *1.检查并且(或者)修改指定的RequestResponse属性

 *2.检查Request属性,生成相应的Response并返回控制权到调用者

 *3.检查RequestReponse属性,包装这些对象并增强它们的功能,然后把它们传

到下一个组件

     *4.如果相应的Response没有被产生(并且控制权也没有被返回)调用Pipleline

上的下一个Valve(如果有)通过方法context.invokeNext()

     *5.检查(但不修改)Response属性(调用后面的ValveContainer产生的)

     *Valve一定不能作下面的事情

     *1.改变Request的一些属性(Change request properties that have

        already been used to direct the flow of processing control

        for this request

       *2.创建一个已经被创建并且已经被传递的Response

     *3.在调用invokeNext()方法并返回后修改包含ResponseHTTP Header信息

     *4.invokeNext()调用返回后在绑定Response上的输出流上作任何调用

     *@param request 将被处理的Request

     *@param response 将被创建的Response

     *@param context 被用来调用下一个ValveValve Context

      public void invoke(Request request, Response response,

                       ValveContext context)

        throws IOException, ServletException;

7.         org.apache.catalina.ValveContext

一个ValveContext是这样一种机制:一个Valve可以触发下一个Valve的调用,而不必知道机制的内在实现。

8.         org.apache.catalina.Engine

Engine是一个容器,是CatalineServlet的入口点。

当发布一个连接到Web ServerCataline时可能不使用Engine,因为Connectior将使用Web Server的资源决定使用哪个Context处理Request

附属于Engine的子容器根据Engine实现的不同可能是HostContext(单个Servlet Context)。

如果使用了Engine,在Cataline的层次中它就是顶层容器,因此setParent()应改抛出IllegalArgumentException异常。从Engine下面几个方法我们可以看出其的结构:

 

 

/**

    * 设定Engine附属的Service

    * @param service The service that owns this Engine

    */

    public void setService(Service service);

 

 

    /**

     * Set the default hostname for this Engine.

     *

     * @param defaultHost The new default host

     */

    public void setDefaultHost(String defaultHost);


 

 

    /**

     * Set the DefaultContext

     * for new web applications.

     *

     * @param defaultContext The new DefaultContext

     */

    public void addDefaultContext(DefaultContext defaultContext);

 

 

9.         org.apache.catalina. Host

Host是一个容器,它代表一个虚拟主机。

当发布一个连接到Web ServerCataline时可能不使用Host,因为Connectior将使用Web Server的资源决定使用哪个Context处理Request

Host所附属的父容器通常是Engine,附属于Host的子容器通常是Context(单个Servlet Context)。

Host接口里面的方法多数都是关于修改Host属性及设定默认的Context。这里我们不再一一列举。

10.      org.apache.catalin. Context

      Context是一个容器,它代表一个ServletContext,一个Cataline Engline中的单个的Web ApplicationContext所附属的父容器是Host,附属于Context的子容器是Wrapper(代表单个Servlet)。Context接口里面多数是关于Web Application的设置的方法,我们可以参考Web.xml文件研究里面的方法,里面多数方法都是如何读取Web.xml文件里的资源。

11.      org.apache.catalina.Wrapper

Wrapper是一个容器,它代表单个ServletWrapper管理Servlet的生命周期,包括调用init()和destory()方法。

Wrapper所附属的父容器是Context,没有附属于Wrapper的子容器,方法addChild()应该抛出IllegalArgumentException异常。

Wrapper接口里面的方法都是关于读取Servlet的属性,可以参考Web.xml文件里面关于<servlet>标签的定义。

12.  org.apache.catalina.Server

Server是整个Catalina容器的入口点,可以包含多个Service和顶层资源元素。一般说来实现Server接口的类也应该同时实现Lifecycle接口,当start()和stop()方法被调用的时候调用Service相应的方法。

   Server负责在指定的端口监听连接,当有连接被接受的时候,Server会分析请求的第一行信息,如果是SHUTDOWNstop服务。可以参考Server.xml文件关于Server的定义。

13.      org.apache.catalina. Service

       Service是一个或多个共享同以ContainerConnectiors的集合。

   JVM可以包含一个或多个Service实例,但它们相互之间是完全独立的,它们仅共享JVM的资源。

14.  org.apache.catalina. Connector

      Connector是一个从客户端接受请求(request)并生成回应(reponse)的组件。一个Connection通常执行下面的逻辑:

1)      从客户端程序接受请求

2)      创建RequestResponse,并把下面这些属性设置到这些对象

1)对所有的RequestconnectorprotocolprotocolresponseschemesecureserverNameserverPortserverPort属性必须被设置。contentLengthcontentType通常也被设置。

3)      对所有的HttpRequestsmethodqueryStringrequestedSessionCookierequestedSessionIdrequestedSessionURLrequestURIsecure属性必须被设置。另外所有addXxx方法也必须被调用以记录cookiesheaderslocales信息。

4)      对所有的Responses属性connectorrequeststream属性必须被设置。

HttpResponses来说,connector不会为它设置额外headers信息。

1.         Tomcat整体架构类图

 Tomcat研究之组件结构

 Tomcat研究之组件结构

下篇将从Tomcat的各个组件入手介绍Tomcat