how tomcat works 读书笔记 十一 StandWrapper 下

StandardWrapperValve

StandardWrapperValve是StandardWrapper的基础阀,主要完成了三个工作。
1 调用StandardWrapper的allocate的方法来获得该StandardWrapper所表示的servlet实例
2 执行与该servelt相关联的全部过滤器
3 调用servlet的service方法

其中第二三步可以细分为
  调用它的 private createFilterChain 方法获得过滤链
  调用过滤器链的 doFilter 方法。这里面就调用了servlet 的 service方法
  释放过滤器链
  调用包装器的deallocate方法

  如果Servlet无法使用了，调用包装器的 unload 方法

我们看看大致的代码片段

// Allocate a servlet instance to process this request
try {
    if (!unavailable) {
    servlet = wrapper.allocate();
    }
}
...
// Acknowlege the request
try {
    response.sendAcknowledgement();
}
...
// Create the filter chain for this request
    ApplicationFilterChain filterChain = createFilterChain(request,servlet);
// Call the filter chain for this request// This also calls the servlet's servicet() method
try {
    String jspFile = wrapper.getJspFile();
    if (jspFile != null)
    sreq.setAttribute(Globals.JSP_FILE_ATTR, jspFile);
    else
    sreq.removeAttribute(Globals.JSP_FILE_ATTR);
    if ((servlet != null) && (filterChain != null)) {
    filterChain.doFilter(sreq, sres);
    }
    sreq.removeAttribute(Globals.JSP_FILE_ATTR);
}
...
// Release the filter chain (if any) for this request
try {
    if (filterChain != null)
        filterChain.release();
}
...
// Deallocate the allocated servlet instance
try {
    if (servlet != null) {
        wrapper.deallocate(servlet);
    }
}
...
// If this servlet has been marked permanently unavailable,
// unload it and release this instance
try {
    if ((servlet != null) && (wrapper.getAvailable() ==Long.MAX_VALUE)) {
        wrapper.unload();
    }
}

看了上面的代码,大家应该能看出来最复杂的部分有两处
其一 ApplicationFilterChain filterChain = createFilterChain(request,servlet);
其二 filterChain.doFilter(sreq, sres);
一步一步来。

FilterDef类

这个类的全名应该是FilterDefinition,过滤器描述类。
里面包含了一个Filter的filterClass,filterName等基本信息,及get/set方法。
这里面的属性,我们可以看看这个

    /**
     * The set of initialization parameters for this filter, keyed by
     * parameter name.
     */
    private Map<String, String> parameters = new HashMap<String, String>();

用HashMap存储了初始化参数,它有get方法,增加属性的方法是addInitParameter(String name, String value)。

ApplicationFilterConfig类

org.apache.catalina.core.ApplicationFilterConfig 实现了javax.servlet.FilterConfig 接口。ApplicationFilterConfig 负责管理 web应用程序启动的时候创建的过滤器实例。
其构造函数如下:
public ApplicationFilterConfig(Context context, FilterDef filterDef)
                                 throws ClassCastException, ClassNotFoundException,IllegalAccessException, InstantiationException, ServletException
在这里我们主要谈谈它的getFilter方法,该方法的功能其实就是加载过滤器类并初始化它。
首先从filterDef里面获得filterClass;

        String filterClass = filterDef.getFilterClass();
        ClassLoader classLoader = null;
        if (filterClass.startsWith("org.apache.catalina."))
            classLoader = this.getClass().getClassLoader();
        else
            classLoader = context.getLoader().getClassLoader();
    .....
            Class<?> clazz = classLoader.loadClass(filterClass);
        this.filter = (Filter) clazz.newInstance();
        filter.init(this);
        return (this.filter);

还是没有什么要说的。

ApplicationFilterChain类

StandardWrapperValve 类中的 invoke 方法创建一个该类的实例并且调用它的 doFilter 方法。ApplicationFilterChain类的doFilter(其实是internalDoFilter)调用该链中第一个过滤器的 doFilter 方法。
ApplicationFilterChain类中,有一个ApplicationFilterConfig的引用

    private ArrayList<ApplicationFilterConfig> filters = new ArrayList<ApplicationFilterConfig>();

看到了把,数组形式来存放链条。

典型的责任链模式。

Filter 接口中doFilter 方法的签名如下：

public void doFilter(ServletRaquest request, ServletResponse response,FilterChain chain)
            throws java.io.IOException, ServletException
在ApplicationFilterChain的doFilter方法中，它会将自己作为第三个参数传递给它。
我们看一个Filter实现类的例子
public void doFilter(ServletRequest request, ServletResponse response,
                    FilterChain chain) throws IOException, ServletException {
    // do something here
    ...
    chain.doFilter(request, response);
}

循环往复了
此处的循环不是那么容易理解,建议参考鄙人的另一篇博客

http://blog.csdn.net/dlf123321/article/details/40078583

等所有的Filter都执行完了,就是下面的代码

           if ((request instanceof HttpServletRequest) &&
                (response instanceof HttpServletResponse)) {
                servlet.service((HttpServletRequest) request,
                                (HttpServletResponse) response);
            } else {
                servlet.service(request, response);
            }

什么时候Filter才算执行完了呢?

 private Iterator<ApplicationFilterConfig> iterator = null;

....

 if (this.iterator == null)
            this.iterator = filters.iterator();

        // Call the next filter if there is one
        if (this.iterator.hasNext()) {

                    //执行filter

       }
...
      //调用servlet的service的代码块
...

应用程序

和之前的几章没有什么区别,不再赘述。