本手册包含关于可包含在 conf/server.xml
文件中以配置 Tomcat Servlet/JSP 容器行为的所有配置指令的参考信息。它不尝试描述应使用哪些配置指令来执行特定任务——为此,请参阅主索引页面上的各种 操作指南 文档。
Tomcat 配置文件格式为无模式 XML;元素和属性区分大小写。支持 Apache Ant 风格的变量替换;名称为 propname
的系统属性可以使用 ${propname}
语法在配置文件中使用。所有系统属性都可用,包括使用 -D
语法设置的、由 JVM 自动提供的以及在 $CATALINA_BASE/conf/catalina.properties
文件中配置的属性。
配置元素描述分为以下主要类别
- 顶级元素 -
<Server>
是整个配置文件的根元素,而<Service>
表示与 Engine 关联的一组连接器。 - 连接器 - 表示外部客户端向特定 Service 发送请求(并从其接收响应)的接口。
- 容器 - 表示其功能是处理传入请求并创建相应响应的组件。一个 Engine 处理一个 Service 的所有请求,一个 Host 处理一个特定虚拟主机的所有请求,一个 Context 处理一个特定 Web 应用程序的所有请求。
- 嵌套组件 - 表示可以嵌套在容器元素内部的元素。有些元素可以嵌套在任何容器内部,而另一些则只能嵌套在 Context 内部。
对于每个元素,相应的文档遵循以下通用大纲
- 简介 - 此特定组件的总体描述。将有一个相应的 Java 接口(在
org.apache.catalina
包中),由一个或多个标准实现实现。 - 属性 - 此元素合法的属性集。通常,这将细分为所有相应 Java 接口实现都支持的通用属性,以及特定于实现此接口的特定 Java 类的标准实现属性。必填属性的名称会加粗。
- 嵌套组件 - 列举了哪些嵌套组件可以合法地嵌套在此元素中。
- 特殊功能 - 描述了此接口的标准实现所支持的各种特殊功能(特定于每种元素类型)的配置。