概觀

概觀

本手冊包含有關所有組態指令的參考資訊,這些指令可以包含在 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 類別的標準實作屬性。必要屬性的名稱會加粗
  • 巢狀元件 - 列舉哪些巢狀元件可以在這個元素內合法嵌套。
  • 特殊功能 - 描述這個介面的標準實作支援的各種特殊功能(特定於每個元素類型)的組態。