本文分析Engine组件，它表示整个Catalina servlet引擎，可以包含一个或多个子容器，如Host或者Context等。
Engine组件
Engine组件表示整个请求处理的机构，它从一个或多个Connector中接收并处理请求，并将响应返回给Connector。Service元素内有且仅能有一个Engine元素。Engine接口继承了Container接口，StandardEngine类继承ContainerBase基类并实现了Engine接口，其部分代码如下所示：
public class StandardEngine extends ContainerBase implements Engine {
public StandardEngine() {
super();
pipeline.setBasic(new StandardEngineValve());
/* Set the jmvRoute using the system property jvmRoute */
try {
setJvmRoute(System.getProperty("jvmRoute"));
} catch(Exception ex) {
log.warn(sm.getString("standardEngine.jvmRouteFail"));
}
// By default, the engine will hold the reloading thread
backgroundProcessorDelay = 10;
}
private String defaultHost = null;
private Service service = null;
@Override
public String getDefaultHost() {
return (defaultHost);
}
@Override
public void setDefaultHost(String host) {
String oldDefaultHost = this.defaultHost;
if (host == null) {
this.defaultHost = null;
} else {
this.defaultHost = host.toLowerCase(Locale.ENGLISH);
}
support.firePropertyChange("defaultHost", oldDefaultHost,
this.defaultHost);
}
@Override
public Service getService() {
return (this.service);
}
@Override
public void setService(Service service) {
this.service = service;
}
@Override
public void addChild(Container child) {
if (!(child instanceof Host))
throw new IllegalArgumentException
(sm.getString("standardEngine.notHost"));
super.addChild(child);
}
// 省略一些代码
}
- defaultHost表示Engine中的默认主机名，使用servel.xml配置时必须与一个Host元素的名称相匹配；
- service表示该Engine所处的Service；
- 其余变量的含义可以参考Engine的配置文档。
构造函数为自己的Pipeline添加了基本阀StandardEngineValve。Engine组件没有父容器，只有父Service（因为Engine在server.xml中是Service的子元素），addChild方法只能添加Host组件。
组件初始化
初始化时调用基类ContainerBase的对应方法为自己创建线程池。
@Override
protected void initInternal() throws LifecycleException {
// Ensure that a Realm is present before any attempt is made to start
// one. This will create the default NullRealm if necessary.
getRealm();
super.initInternal();
}
组件启动
启动时调用基类ContainerBase的对应方法启动各Host。
@Override
protected synchronized void startInternal() throws LifecycleException {
// Log our server identification information
if(log.isInfoEnabled())
log.info( "Starting Servlet Engine: " + ServerInfo.getServerInfo());
// Standard container startup
super.startInternal();
}
