How Tomcat works之第十一章之The ServletConfig 对象

StandardWrapper类的loadServlet方法在Servlet被加载后调用后调用sender的init方法。此方法传递了一个ServletConfig的实例。你可能想知道StandardWrapper对象如何获取这个ServletConfig对象。

就看这个类StandardWrapper本身，除了实现了ServletConfig接口外，还实现了Wrapper接口。

第一个接口有一下四种方法：getServletContext方法，getServletName方法，getInitParameter方法和getInitParameterNames方法。现在看看这个四种方法在StandardWrapper类中是如何实现的。

注意StandardWrapper不传递自身给Servlet的init方法。而是将自身封装为一个StandardWrapperFacade实例来对Servlet开发者隐藏public方法。

  getServletContext

方法名标签：

public  ServletContext getServletContext（）

一个StandardWrapper实例必须是一个StandardContext的子容器。这就是说，一个StandardWrapper的父类是一个StandardContext。从StandardContext对象中，你可以调用它的getServletContext方法获取一个ServletContext对象。下面是这个方法的代码实现：

public ServletContext getServletContext() {
   if (parent == null)
      return (null);
   else if (!(parent instanceof Context))
      return (null);
   else
      return (((Context) parent).getServletContext());
}

注意 现在你知道了 不能单独部署一个wrapper来表示一个Servlet定义。wrapper必须在一个Context中这样ServletConfig对象能返回一个ServletContext实例，当它的getServletContext方法被调用的时候。

getServletName

这个方法返回Servlet的名字。方法标签如下：

public  String getServletName()

这个方法在StandardWrapper类中的实现如下：

public String getServletName(){

      return (getName());

}

它简单地调用了ContainerBase类的getName方法 ，此方法代码如下：

public  String getName(){

      return (name);

}

你可以通过SetName方法设置name的值。

getInitParameter

这个方法返回指定初始化参数的值。方法签名如下：

public  String  getInitParameter(String name)

在StandardWrapper中，初始化参数存放在一个命名为parameters的HashMap中。

private  HashMap parameters = new HashMap();

调用StandardWrapper类的addInitParameter方法并传递这个参数的名字和值，植入parameters。

public void addInitParameter(String name, String value) {
   synchronized (parameters) {
      parameters.put(name, value);
   }
   fireContainerEvent("addInitParameter", name);
}

这里是StandardWrapper类中的getInitParameter方法的实现；

public String getInitParameter(String name) {
   return (findInitParameter(name));
}

findInitParameter方法获取参数名并调用parameters的HashMap的get方法。findInitParameter方法代码如下：

public void addChild(Container child) {
   throw new IllegalStateException
      (sm.getString("StandardWrapper.notChild"));
}

getInitParameterNames

这个方法返回一个Enumeration，包含了初始化参数的所有名字。它的方法标签如下：

public  Enumeration getInitParameterNames()

在StandardWrapper类中getInitParameterNames方法实现如下：

public Enumeration getInitParameterNames() {
   synchronized (parameters) {
      return (new Enumerator(parameters.keyset()));
   }
}

Enumerator类实现了java.util.Enumeration，是org.apache.catalian.util包的一部分。