HTTP 端點 (httpEndpoint)
HTTP 端點的配置內容。
| 屬性名稱 | 資料類型 | 預設值 | 說明 |
|---|---|---|---|
| accessLoggingRef | 最上層 httpAccessLogging 元素的參照(字串)。 | 端點的 HTTP 存取記載配置。 | |
| 已啟用 | 布林 | True | 切換端點的可用性。 當設為 true 時,分派器會啟動這個端點來處理 HTTP 要求。 |
| host | 字串 | localhost | 用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只有 DNS 主機名稱。 使用 '*' 作為所有可用的網路介面。 |
| httpOptionsRef | 最上層 httpOptions 元素的參照(字串)。 | defaultHttpOptions | 端點的 HTTP 通訊協定選項。 |
| httpPort | int 下限:-1 上限:65535 |
用戶端 HTTP 要求所用的埠。使用 -1 停用這個埠。 | |
| httpsPort | int 下限:-1 上限:65535 |
受 SSL 保護的用戶端 HTTP 要求 (https) 所用的埠。 使用 -1 停用這個埠。 | |
| id | 字串 | 唯一的配置 ID。 | |
| onError |
|
WARN | 啟動端點失敗之後,要採取的動作。
|
| sslOptionsRef | 最上層 sslOptions 元素的參照(字串)。 | 端點的 SSL 通訊協定選項。 | |
| tcpOptionsRef | 最上層 tcpOptions 元素的參照(字串)。 | defaultTCPOptions | 端點的 TCP 通訊協定選項。 |
- accessLogging
說明: 端點的 HTTP 存取記載配置。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 已啟用 布林 True 啟用存取記載。 filePath 檔案的路徑 ${server.output.dir}/logs/http_access.log 存取日誌檔的目錄路徑和名稱。 指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。 logFormat 字串 %h %u %{t}W "%r" %s %b 指定記載用戶端存取資訊時,所用的日誌格式。 maxFileSize int 下限:0
20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。 maxFiles int 下限:0
2 在移除最舊的檔案之前,所要保存的日誌檔數目上限;0 值表示無限制。
- httpOptions
說明: 端點的 HTTP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 keepAliveEnabled 布林 True 啟用持續連線(HTTP 保持作用中)。 如果是 true,連線會保持作用中,供多個循序的要求和回應重複使用。 如果是 false,傳回回應之後,連線會關閉。 maxKeepAliveRequests int 下限:-1
100 在啟用持續連線的情況下,單一 HTTP 連線所接受的持續要求數目上限。 -1 值表示無限制。 persistTimeout 具有秒精準度的時間量 30s 在要求之間,Socket 可以維持閒置的時間量。 只有在啟用持續連線之時,這個設定才適用。 請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 readTimeout 具有秒精準度的時間量 60s 在進行第一次讀取之後,在 Socket 上等待讀取要求完成的時間量。 請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 removeServerHeader 布林 false 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。 writeTimeout 具有秒精準度的時間量 60s 在 Socket 上等待傳輸每部分回應資料的時間量。 請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。
- sslOptions
說明: 端點的 SSL 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 sessionTimeout 具有秒精準度的時間量 1d 在 Socket 上等待讀寫要求完成的時間量。通訊協定特定的逾時會置換這個值。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 sslRef 最上層 ssl 元素的參照(字串)。 預設 SSL 配置儲存庫。預設值為 defaultSSLSettings。 suppressHandshakeErrors 布林 false 停用 SSL 信號交換錯誤的記載。SSL 信號交換錯誤有可能出現在正常作業期間,不過,當 SSL 行為不符合預期時,這些訊息可能很有用。
參照主題