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