伺服器元件

目錄

簡介

伺服器元素代表整個 Catalina servlet 容器。因此，它必須是 conf/server.xml 組態檔案中的最外層元素。它的屬性代表 servlet 容器整體的特徵。

屬性

常見屬性

所有 伺服器實作都支援下列屬性

屬性 說明
className

要使用的實作的 Java 類別名稱。此類別必須實作 org.apache.catalina.Server 介面。如果未指定類別名稱，將使用標準實作。

address

此伺服器等待關閉命令的 TCP/IP 位址。如果未指定位址，將使用 localhost。

port

此伺服器等待關閉命令的 TCP/IP 埠號。設為 -1 以停用關閉埠。

注意：當 Tomcat 使用 Apache Commons Daemon 啟動（在 Windows 上以服務方式執行或在 un*xes 上使用 jsvc）時，停用關閉埠會很有效。不過，當使用標準 shell 指令碼執行 Tomcat 時，無法使用此方式，因為它會阻止 shutdown.bat|.sh 和 catalina.bat|.sh 優雅地停止 Tomcat。

portOffset

套用至 port 和任何巢狀連接器埠的位移量。它必須是非負整數。如果未指定，將使用預設值 0。

shutdown

必須透過 TCP/IP 連線傳送至指定埠號的命令字串，才能關閉 Tomcat。

utilityThreads

此服務將用於各種實用程式任務（包括經常性任務）的執行緒數目。特殊值 0 會導致使用 Runtime.getRuntime().availableProcessors() 的值。負值會導致使用 Runtime.getRuntime().availableProcessors() + value，除非其小於 1，否則將使用 1 個執行緒。預設值為 1。

標準實作

伺服器的標準實作為 org.apache.catalina.core.StandardServer。它支援下列其他屬性（除了上述列出的共用屬性）

屬性 說明
utilityThreadsAsDaemon

設定實用程式執行緒的守護程序旗標值。預設值為 false。

periodicEventDelay

此值代表此伺服器上設定的生命週期監聽器週期性生命週期事件呼叫之間的延遲（以秒為單位）。此值以秒為單位，而負值或零值會停用呼叫。如果未指定，此屬性的預設值為 10 秒。

巢狀元件

下列元件可以嵌套在 伺服器元素內

特殊功能

伺服器沒有任何特殊功能。