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包的一部分。