概述

概述

本手册包含关于可包含在 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 类的标准实现属性。必填属性的名称会加粗
  • 嵌套组件 - 列举了哪些嵌套组件可以合法地嵌套在此元素中。
  • 特殊功能 - 描述了此接口的标准实现所支持的各种特殊功能(特定于每种元素类型)的配置。