这个手册包括可能被包括在conf/server.xml
文件里来配置Tomcat 5 Servlet/JSP容器行为的所有配置指令的参考信息。这里没有描述哪些配置指令应该被怎样用来执行哪些特殊的任务——关于这些,参看主要索引页面(main index page)里的各种HOW-TO文档资料。
关于配置元素的描述被组织成下列几种主要类型:
- 最上层元素 -
<Server>
是整个配置文件的根元素,而<Service>
代表与Engine相关联的一组连接器。
- 连接器 - 代表发送请求的(以及接受回应的)外部客户与某个特定服务之间的界面。
- 容器 - 代表那些具有处理接收到的请求和产生相应的回应功能的组件。一个Engine为一个Service处理所有的请求,一个Host为一个特殊的虚拟机处理所有的请求,一个Context为一个特定的web应用程序处理所有的请求。
- 嵌套的组件 - 代表那些可以被嵌套在一个容器元素里的元素。有些元素可以嵌套在任何容器里,而另外一些则仅仅能被嵌套在一个Context里。
对于每个元素,其相应的文档资料遵循下面这个一般大纲:
- 简介 - 关于这个特殊组件的全面描述。这里会有一个被一个或多个标准实现执行的相应的Java界面(在
org.apache.catalina
软件包里)。
- 属性 - 对这个元素合法的一组属性。通常,这组属性又被再分为两组:一组是被这个相应的Java界面的所有实现支持的公用属性,另一组是执行这个界面的某一特别的Java类所特定的标准实现属性。所必需的属性名称是被强调粗写的(bolded)。
- 嵌套的组件 - 列举哪些嵌套的组件可以被合法地嵌套在这个元素里边。
- 特别性能 - 描述了被这个界面的标准实现支持的多种特别性能(每个元素类型所特定的)的配置。