how tomcat works 读书笔记十一 StandWrapper 上

方法调用序列

下图展示了方法调用的协作图:

这个是前面第五章里,我画的图:

我们再回顾一下自从连接器里

connector.getContainer().invoke(request, response);

这句代码运行之后发生的事情;

这是第五章的时序图,放在这一章同样适用。。。

我们仔细分析一下:

1首先连接器创建请求与响应对象;

2调用这行代码

connector.getContainer().invoke(request, response)

(我们一StandContext为顶层容器)

3在容器里会先调用StandardPipeline的invoke方法。如下:

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

        // Invoke the first Valve in this pipeline for this request
        (new StandardPipelineValveContext()).invokeNext(request, response);

    }

4StandardPipeline有个内部类StandardPipelineValveContext,它的invokeNext方法会循环管道(StandardContext的管道)里的所有阀,直到基础阀,并且调用其invoke方法。基础阀在StandardContext初始化的时候就默认指定了StandardContextValve();

5基础阀的invoke方法调用StandardContext的map方法得到Wrapper

6调用得到的wrapper(这里是StandardWrapper)的invoke方法...

7先重复上面的第三第四步,这时获得的基础阀是StandardWrapperValve,它的invoke方法就是调用StandardWrapper类的allocate方法,allocate调用loadServlet获得servlet。

8产生一个在ApplicationFilterChain:createFilterChain(request, servlet),然后在其internalDoFilter方法中调用servlet的service方法。

SingleThreadModel接口

这个接口能保证,在容器内部,任何时候只有一个进程访问某个serlvet的service方法。

这个接口是一个空接口,或者叫标志接口,内部什么都没有。就是一种标示而已。

实现此接口的一个servlet通俗称为SingleThreadModel（STM）的程序组件。

一个SingleThreadModel组件,可以保证在任何时候,只有一个线程来访问自己。

很多程序员以为,只要实现了上述接口就能保证自己的servlet是线程安全的。

其实不然,因为尽管stm可以保证一个servlet可以只被一个线程访问,但因为效率的关系,对于stm,tomcat会设置一个servletpool,里面会放置多个servlet(都是某一个servlet的实例,当然一个 StanderWrapper也就管一个servlet类)那么这个时候就会出问题了,例如如果若干个servlet的service方法都访问某个静态类的变量或servelt类以外的类或变量呢?

StandardWrapper

StandardWrapper的主要作用就是载入它自己所代表的servlet类,并进行实例化,但是通过分析上面的调用时序图,大家知道它是先调用自己的管道,然后是基础阀,由基础阀调用StandardWrapper的alloacte方法。

上面已经说了,有个STM,如果容器只是维护一个实现了STM接口的servelt那么调用的时候就应该是这样的

    Servlet instance = <get an instance of the servlet>;
    if ((servlet implementing SingleThreadModel>) {
        synchronized (instance) {
            instance.service(request, response);
        }
    }
    else {
        instance.service(request, response);
    }

不过为了保持性能,StandardWrapper一般维护了一个STM servlet 实例池。

一个包装器还负责准备一个 javax.servlet.ServletConfig 的实例，这可以在

servlet 内部完成，接下来两小节讨论如何分配和加载 servlet。

Alloacte方法

本方法其实可以分为两部分:

第一产生非STMServlet

StandardWrapper 定义一个 java.servlet.Servlet 类型的实例

private Servlet instance = null;

方法 allocate 检查该实例是否为 null，如果是调用 loadServlet 方法来加载servlet。然后增加 contAllocated 整型并返回该实例。

第二产生STMServlet

方法 allocate 尝试返回池中的一个实例，变量intancePool是一个java.util.Stack类型的 STM servlet实例池。

在这里我需要给大家解释三个变量:

countAllocated: 目前存活的servelt数量

the count of allocations that are currently active (even if they are for the same instance, as will be true on a non-STM servlet).

nInstances : 已经加载的serlvet数量

Number of instances currently loaded for a STM servlet.

maxInstances: 这个看名字就知道了,StandardWrapper支持的最大数目的servlet。

上面三个变量肯定把大家搞晕了,但是我想说记着一个StandardWrapper就维护一个servlet,它只有一个class地址,那三个变量是在多线程的时候用的!

这部分的代码比较麻烦,不管是理解还是说都很麻烦

总而言之,最开始的时候countAllocated与nInstances都是0,先loadServlet()出一个servelt,push到servlet实例池里面,然后取出来..

这部分大家自己看代码吧(我觉得自己偷的一把好懒呀)

loadServlet方法

这个方法首先会回检查instance,如果不为null,并且当前的StandardWrapper并不表示一个STMServlet类,那么就直接返回。

另一方面,Catalina也是jsp容器,如果请求的servelt是一个jsp就执行下面的代码段:

            String actualClass = servletClass;

            if ((actualClass == null) && (jspFile != null)) {

                Wrapper jspWrapper = (Wrapper)((Context) getParent()).findChild(Constants.JSP_SERVLET_NAME);

                if (jspWrapper != null)

                    actualClass = jspWrapper.getServletClass();

            }

下面就是获得classloader,默认情况下,我们看前面几章的内容就知道,在Bootstrap里我们就已经指定了WebappLoader,通过它,我们可以获得WebappClassLoader这个对象。

不过在tomcat中,如果要加载的servlet位于org.apache.catalina.下,那么classLoader就是

       classLoader = this.getClass().getClassLoader(); //this 就是StandardWrapper

再下来就是loadClass,接着用Class的newInstance获得servlet;

下来就是检查该servlet是否允许载入(这步我看的不是很懂),看它是否实现了ContainerServlet接口。

ContainerServlet接口中有set/getWrapper方法,就是可以让servlet访问Catalina的内部功能。

下面就是调用 servlet.init(facade);这个facade是javax.servlet.ServletConfig的一个外观变量。

如果该StandardWrapper对象表示的是一个STM Servlet，将该实例添加到实例池中，因此，如果实例池如果为null，首先需要创建它。

   // Register our newly initialized instance

   singleThreadModel = servlet instanceof SingleThreadModel;

   if (singleThreadModel) {

   if (instancePool == null)

       instancePool = new Stack();

   }

   fireContainerEvent("load", this);

    }

最后返回servlet。

ServletConfig对象

上面servlet的init方法的参数实际上就是javax.servlet.ServletConfig接口的实例。

问题出现了,这个接口的实例从哪来来呢?大家看看StandardWrapper的声明部分,就知道它本身就实现了ServletConfig接口。

但是在调用init方法是,StandardWrapper并不会直接把自己传过去而是使用了一个facade,为什么我主要是直接把StandardWrapper传过去,那么StandardWrapper里面的所有public方法不都暴露了么?

ServletConfig 接口有以下四个方法getServletContext,getServletName,getInitParameter,和getInitParameterNames。

1 getServletContext

     public ServletContext getServletContext() {

        if (parent == null)

            return (null);

        else if (!(parent instanceof Context))

            return (null);

        else

            return (((Context) parent).getServletContext());

    }

现在你知道不能单独部署一个包装器来表示一个 Servlet，包装器必须从属于一个上下文容器，这样才能使用 ServletConfig 对象使用getServletContext 方法获得一个 ServletContext 实例。

2 getServletName

获得servlet的名字,没有什么好说的

3 getInitParameter

获得指定的初始参数的值。StandardWrapper中的初始参数放在一个HashMap中:

private HashMap<String, String> parameters = new HashMap<String, String>();

具体的实现大家看代码,这块很简单。

4 getInitParameterNames

返回的是初始化参数的名字的集合,是一个枚举类。

StandardWrapperFacade类

类图如下:

ServletConfig共有四个方法,facade类getServletName,getInitParameter,getInitParameterNames都是直接调用StandardWrapper,这些都比较简单,没有什么要说的。

不过getServletContext就有点复杂了:

    public ServletContext getServletContext() {

        ServletContext theContext = config.getServletContext();

        if ((theContext != null) &&

            (theContext instanceof ApplicationContext))

            theContext = ((ApplicationContext) theContext).getFacade();

        return (theContext);

    }

看到了吧,先调用StandardWrapper获得Context,但是这里最后给外面返回的还是Facade。(真tm复杂)。

下面的章节我们会讲

StandardWrapperValve,FilterDef,ApplicationFilterConfig,ApplicationFilterChain