HTTP 階段作業 (httpSession)
HTTP 階段作業管理的配置。
| 屬性名稱 | 資料類型 | 預設值 | 說明 |
|---|---|---|---|
| allowOverflow | 布林 | True | 容許記憶體內的階段作業數目超出「記憶體內階段作業數目上限」內容的值。 |
| alwaysEncodeUrl | 布林 | false | Servlet 2.5 規格指定,若非必要,不在 response.encodeURL 呼叫上進行 URL 編碼。 如果要在啟用 URL 編碼時支援舊版相容性,請將這個內容設為 true 來呼叫 encodeURL 方法。 URL 一律會編碼,即使瀏覽器支援 Cookie 也一樣。 |
| cloneId | 字串 | 叢集成員的複本 ID。在叢集內,這個 ID 必須是唯一的,以便維護階段作業親緣性。當設定時,這個名稱會改寫伺服器產生的預設名稱。 | |
| cloneSeparator | 字串 | : | 用來區隔階段作業 ID 與階段作業 Cookie 中的複本 ID 的單一字元。通常應該使用預設值。 在某些「無線應用程式通訊協定 (WAP)」裝置上,不接受冒號 (:),因此,應該改用加號 (+)。 不同的值應該少用。 利用這個內容來變更複本分隔字元之前,您應該先瞭解系統上所執行的其他產品的複本字元需求。 任何字元都可以指定為這個內容值,但這不代表您指定的字元能夠正確運作。 此外,這個事實也不意味著 IBM 會負責修正因使用替代字元而可能出現的任何問題。 |
| cookieDomain | 字串 | 階段作業追蹤 Cookie 的網域欄位。 | |
| cookieHttpOnly | 布林 | True | 指定階段作業 Cookie 包括 HttpOnly 欄位。 支援 HttpOnly 欄位的瀏覽器不會讓用戶端 Script 存取 Cookies。 使用 HttpOnly 欄位有助於防止跨網站 Scripting 攻擊。 |
| cookieMaxAge | 具有秒精準度的時間量 | -1 | Cookie 存在於用戶端瀏覽器中的時間量上限。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 |
| cookieName | 字串 | JSESSIONID | 階段作業管理 Cookie 的唯一名稱。 |
| cookiePath | 字串 | / | 將 Cookie 傳送到路徑中所指定的 URL。 |
| cookieSecure | 布林 | false | 指定階段作業 Cookie 是否包含安全欄位。 |
| cookiesEnabled | 布林 | True | 指定階段作業追蹤要利用 Cookie 來攜帶階段作業 ID。 |
| debugCrossover | 布林 | false | 啟用這個選項會執行其他檢查,確認只處理或參照與要求相關聯的階段作業,如果偵測到任何不相符之處,便記載訊息。 停用這個選項會跳過其他檢查。 |
| forceInvalidationMultiple | int | 3 | 如果您的要求通常沒有回應時間限制,請指定 0,表示在階段作業失效之前,階段作業管理程式應該無限期等待要求完成。 否則,請將這個內容設為一個正整數來延遲作用中階段作業的失效。 作用中的逾時階段作業不會在第一個失效間隔失效,而等到基於這個值的間隔時失效。 比方說,如果是 2 值,過了階段作業逾時值之後,第二個失效間隔才會使作用中的階段作業失效。 |
| idLength | int | 23 | 階段作業 ID 的長度。 |
| idReuse | 布林 | false | 在未配置階段作業持續性的多重 JVM 環境中,將這個內容設為 "true",階段作業管理程式可以將相同的階段作業資訊用於所有使用者要求,即使處理這些要求的 Web 應用程式是由不同的 JVM 來控管也一樣。 這個內容的預設值為 false。如果您想讓階段作業管理程式能夠利用瀏覽器傳送的階段作業 ID,在未針對階段作業持續性配置的環境中,保存執行中之各 Web 應用程式之間的階段作業資料,請將這個內容設為 true。 |
| invalidateOnUnauthorizedSessionRequestException | 布林 | false | 如果在回應未獲授權的要求時,您想要階段作業管理程式使階段作業失效,而不是發出 UnauthorizedSessionRequestException,請將這個內容設為 true。 當階段作業失效時,要求端可以建立一個新的階段作業,但無法存取先前所儲存的任何階段作業資料。 如此單一使用者就可以在登出之後,繼續處理對其他應用程式的要求,同時階段作業資料仍會受到保護。 |
| invalidationTimeout | 具有秒精準度的時間量 | 30m | 階段作業不再有效之前,可以保持未用的時間量。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 |
| maxInMemorySessionCount | int | 1000 | 每個 Web 模組在記憶體中保留的階段作業數上限。 |
| noAdditionalInfo | 布林 | false | 強制移除階段作業 ID 中所不需要的資訊。 |
| protocolSwitchRewritingEnabled | 布林 | false | 當 URL 需要從 HTTP 切換至 HTTPS 或從 HTTPS 切換至 HTTP 時,將階段作業 ID 新增至 URL 中。 |
| reaperPollInterval | 具有秒精準度的時間量 | -1 | 移除無效階段作業的程序的起動間隔(秒)。 最小值是 30 秒。 如果輸入的值比最小值小,會自動判斷及使用適當的值。 這個值會置換在 30 和 360 秒之間,基於階段作業逾時值的預設安裝值。 由於預設階段作業逾時值是 30 分鐘,收獲間隔通常在 2 和 3 分鐘之間。請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m) 或秒 (s)。 例如,30 秒指定為 30s。 單一項目可以包含多個值。比方說,1m30s 相當於 90 秒。 |
| rewriteId | 字串 | jsessionid | 請利用這個內容來變更 URL 重新編寫所使用的金鑰。 |
| securityIntegrationEnabled | 布林 | True | 啟用安全整合,讓階段作業管理機能將使用者身分關聯於他們的 HTTP 階段作業。 |
| securityUserIgnoreCase | 布林 | false | 指出即使大小寫不同,也應該將階段作業安全身分和用戶端安全身分視為相符。 比方說,當這個內容設為 true 時,階段作業安全身分 USER1 符合用戶端安全身分 User1 和 user1。 |
| sslTrackingEnabled | 布林 | false | 指定階段作業追蹤要利用 Secure Socket Layer (SSL) 資訊來作為階段作業 ID。 |
| urlRewritingEnabled | 布林 | false | 指定階段作業管理機能要用重新撰寫的 URL 來攜帶階段作業 ID。 |
| useContextRootAsCookiePath | 布林 | false | 指定 Cookie 路徑等於 Web 模組的環境定義根目錄,而不是 / |
參照主題