Java Servlets 3.1
這個特性支援將 HTTP Servlet 寫入至 Java Servlet 3.1 規格。您可以將 Servlet 包裝在 Java EE 指定的 WAR 或 EAR 檔中。如果需要 Servlet 安全,也應該配置 appSecurity 特性。如果沒有安全特性,會忽略應用程式的任何安全限制。
啟用這項特性
<feature>servlet-3.1</feature>
支援的 Java™ 版本
- JavaSE-1.7
- JavaSE-1.8
開發相依於這項特性的特性
com.ibm.websphere.appserver.servlet-3.1; type="osgi.subsystem.feature"
啟用這項特性的特性
- Admin Center
- Application Security 1.0
- Collective Member
- Java RESTful Services 1.1
- Java RESTful Services Client 2.0
- Java Persistence API 2.0
- JavaServer Faces 2.0
- JavaServer Faces 2.2
- JavaServer Pages 2.2
- JavaServer Pages 2.3
- OAuth
- OpenID
- OpenID Connect Client
- OpenID Connect Provider
- OSGi Java Persistence API
- JMX REST Connector
- Simple and Protected GSSAPI Negotiation Mechanism
- OSGi Web Application Bundles
- Web Response Cache
- Java EE Web Profile 7.0
- Java WebSocket 1.0
- Java WebSocket 1.1
這項特性提供的標準 API 套件
- javax.servlet
- javax.servlet.annotation
- javax.servlet.descriptor
- javax.servlet.http
- javax.servlet.resources
這項特性提供的 IBM API 套件
這項特性提供的 SPI 套件
- com.ibm.websphere.servlet.filter
- com.ibm.websphere.servlet.response
- com.ibm.ws.webcontainer.extension
- com.ibm.wsspi.webcontainer
- com.ibm.wsspi.webcontainer.collaborator
- com.ibm.wsspi.webcontainer.extension
- com.ibm.wsspi.webcontainer.filter
- com.ibm.wsspi.webcontainer.metadata
- com.ibm.wsspi.webcontainer.osgi.extension
- com.ibm.wsspi.webcontainer.servlet
- com.ibm.wsspi.webcontainer.webapp
特性配置元素
您可以在 server.xml 檔中使用下列元素,來配置 Java Servlets 3.1 特性:
- application
- applicationMonitor
- channelfw
- classloading
- enterpriseApplication
- httpAccessLogging
- httpDispatcher
- httpEncoding
- httpEndpoint
- httpOptions
- httpProxyRedirect
- httpSession
- javaPermission
- library
- mimeTypes
- pluginConfiguration
- tcpOptions
- virtualHost
- webApplication
- webContainer
- application
- 定義應用程式的內容。
屬性名稱 資料類型 預設值 說明 autoStart boolean true 指出伺服器是否自動啟動應用程式。 context-root string 應用程式的環境定義根目錄。 id string 唯一的配置 ID。 location 檔案、目錄或 URL。 應用程式的位置,以伺服器層次應用程式目錄的絕對路徑或相對路徑表示。 name string 應用程式的名稱。 suppressUncoveredHttpMethodWarning boolean false 在應用程式部署期間用來暫停未涵蓋的 HTTP 方法警告訊息的選項。 type string 應用程式保存檔的類型。 - application > application-bnd
說明: 將應用程式中所包含的一般部署資訊連結到特定的資源。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 version string 應用程式連結規格的版本。 - application > application-bnd > security-role
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name string 安全角色的名稱。 - application > application-bnd > security-role > group
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 access-id string 群組存取 ID id string 唯一的配置 ID。 name string 佔有安全角色的群組名稱。
- application > application-bnd > security-role > run-as
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 password 可逆的編碼密碼(字串) 從一個 Bean 存取另一個 Bean 所需的使用者密碼。其值可以用明碼或編碼形式儲存。如果要將密碼編碼,請搭配使用 securityUtility 工具與編碼選項。 userid string 從一個 Bean 存取另一個 Bean 所需的使用者 ID。
- application > classloader
說明: 定義應用程式類別載入器的設定。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 classProviderRef 最上層 resourceAdapter 元素的參照清單(逗點區隔的字串)。 類別提供者參照清單。當搜尋類別或資源時,這個類別載入器會搜尋其本身的類別路徑,之後委派給指定的類別提供者。 commonLibraryRef 最上層 library 元素的參照清單(逗點區隔的字串)。 程式庫參照的清單。會與其他類別載入器共用程式庫類別實例。 delegation - parentFirst
- parentLast
parentFirst 控制在這個類別載入器之前或之後是否使用母項類別載入器。如果選取母項優先,則會先委派給原生母項,再搜尋類別路徑。如果選取母項最後,則會先搜尋類別路徑,再委派給原生母項。 - parentFirst
- 母項優先
- parentLast
- 母項最後
privateLibraryRef 最上層 library 元素的參照清單(逗點區隔的字串)。 程式庫參照的清單。程式庫類別實例是此類別載入器所特有,不依賴其他類別載入器的類別實例。 - application > classloader > commonLibrary
說明: 程式庫參照的清單。會與其他類別載入器共用程式庫類別實例。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 description string 管理者的共用程式庫說明 filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。 參照的檔案集 ID id string 唯一的配置 ID。 name string 管理者的共用程式庫名稱 - application > classloader > commonLibrary > file
說明: 參照的檔案 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name 檔案的路徑 完整檔名
- application > classloader > commonLibrary > fileset
說明: 參照的檔案集 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。 dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。 excludes string 要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。 id string 唯一的配置 ID。 includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。 scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
- application > classloader > privateLibrary
說明: 程式庫參照的清單。程式庫類別實例是此類別載入器所特有,不依賴其他類別載入器的類別實例。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 description string 管理者的共用程式庫說明 filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。 參照的檔案集 ID id string 唯一的配置 ID。 name string 管理者的共用程式庫名稱 - application > classloader > privateLibrary > file
說明: 參照的檔案 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name 檔案的路徑 完整檔名
- application > classloader > privateLibrary > fileset
說明: 參照的檔案集 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。 dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。 excludes string 要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。 id string 唯一的配置 ID。 includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。 scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
- application > resourceAdapter
說明: 指定內嵌在應用程式中的資源配接器的配置。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 alias string ${id} 置換資源配接器的預設 ID。資源配接器的配置內容元素名稱中會使用 ID,進而用來判定資源配接器提供之任何資源的配置內容元素名稱。資源配接器的配置內容元素名稱的格式是 properties.<APP_NAME>.<ALIAS>,其中 <APP_NAME> 是應用程式名稱,<ALIAS> 是所配置的別名。如果沒有指定,會將別名預設為資源配接器的模組名稱。 autoStart boolean 配置一旦部署資源配接器就自動啟動資源配接器,或是延緩到注入或查閱資源時才啟動。 contextServiceRef 最上層 contextService 元素的參照(字串)。 配置如何擷取環境定義並延伸到執行緒。 id string 識別要套用這項配置之內嵌資源配接器模組的名稱。 - application > resourceAdapter > contextService
說明: 配置如何擷取環境定義並延伸到執行緒。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- application > resourceAdapter > contextService > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 id string 唯一的配置 ID。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- application > resourceAdapter > contextService > baseContext > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: com.ibm.ws.context.service-factory
- application > resourceAdapter > contextService > baseContext > classloaderContext
說明: 類別載入器環境定義延伸的配置。必要: false資料類型:
- application > resourceAdapter > contextService > baseContext > jeeMetadataContext
說明: 將提交環境定義作業之應用程式元件的名稱空間提供給作業。必要: false資料類型:
- application > resourceAdapter > contextService > baseContext > securityContext
說明: 當指定此項時,會將工作起始器的安全環境定義延伸到工作單元。必要: false資料類型:
- application > resourceAdapter > contextService > baseContext > syncToOSThreadContext
說明: 當指定時,工作單元的 runAs 主題身分會與作業系統身分同步化。必要: false資料類型:
- application > resourceAdapter > contextService > baseContext > zosWLMContext
說明: 指出「z/OS WLM 環境定義」應納入執行緒環境定義中一起管理。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 daemonTransactionClass string ASYNCDMN 當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 defaultTransactionClass string ASYNCBN 當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 wlm - Propagate
- PropagateOrNew
- New
Propagate 指出應如何處理「非常駐程式」工作的 WLM 環境定義。 - Propagate
- 使用相同的 WLM 環境定義(若有的話)。
- PropagateOrNew
- 使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。
- New
- 一律建立新的 WLM 環境定義。
- application > resourceAdapter > contextService > classloaderContext
說明: 類別載入器環境定義延伸的配置。必要: false資料類型:
- application > resourceAdapter > contextService > jeeMetadataContext
說明: 將提交環境定義作業之應用程式元件的名稱空間提供給作業。必要: false資料類型:
- application > resourceAdapter > contextService > securityContext
說明: 當指定此項時,會將工作起始器的安全環境定義延伸到工作單元。必要: false資料類型:
- application > resourceAdapter > contextService > syncToOSThreadContext
說明: 當指定時,工作單元的 runAs 主題身分會與作業系統身分同步化。必要: false資料類型:
- application > resourceAdapter > contextService > zosWLMContext
說明: 指出「z/OS WLM 環境定義」應納入執行緒環境定義中一起管理。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 daemonTransactionClass string ASYNCDMN 當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 defaultTransactionClass string ASYNCBN 當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 wlm - Propagate
- PropagateOrNew
- New
Propagate 指出應如何處理「非常駐程式」工作的 WLM 環境定義。 - Propagate
- 使用相同的 WLM 環境定義(若有的話)。
- PropagateOrNew
- 使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。
- New
- 一律建立新的 WLM 環境定義。
- application > resourceAdapter > customize
說明: 針對使用指定介面及/或實作類別的啟動規格、受管理物件或 Connection Factory,自訂其配置內容元素。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 implementation string 應自訂其配置內容元素的實作類別完整名稱。 interface string 應自訂其配置內容元素的介面類別完整名稱。 suffix string 置換配置內容元素的預設字尾。例如,properties.rarModule1.CustomConnectionFactory 中的 "CustomConnectionFactory"。當資源配接器提供了多種類型的 Connection Factory、受管理物件或端點啟動時,使用字尾有助於釐清。如果在自訂配置內容元素時省略了字尾或將它留白,則不會使用字尾。
- applicationMonitor
- 定義伺服器回應應用程式新增項目、更新項目和刪除項目的方式。
屬性名稱 資料類型 預設值 說明 dropins 目錄的路徑 dropins 應用程式放置區目錄的位置,以伺服器目錄的絕對路徑或相對路徑表示。 dropinsEnabled boolean true 監視放置區目錄中是否有應用程式新增項目、更新項目和刪除項目。 pollingRate 精準度是毫秒的時間量 500ms 伺服器檢查應用程式新增項目、更新項目和刪除項目的頻率。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 updateTrigger - mbean
- polled
- disabled
polled 應用程式更新方法或觸發程式。 - mbean
- 只有在被外部程式(如整合開發環境或管理應用程式)所呼叫的 MBean 提示時,伺服器才會更新應用程式。
- polled
- 伺服器會在輪詢間隔掃描應用程式變更,並更新任何具有可偵測變更的應用程式。
- disabled
- 停用所有更新監視。伺服器正在執行時,將不會套用應用程式變更。
- channelfw
- 定義通道和鏈結管理設定。
屬性名稱 資料類型 預設值 說明 chainQuiesceTimeout 精準度是毫秒的時間量 30s 靜止鏈結時的預設等待時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 chainStartRetryAttempts int 下限:0
60 每個鏈結進行重試的次數。 chainStartRetryInterval 精準度是毫秒的時間量 5s 啟動重試之間的時間間隔。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 warningWaitTime 精準度是毫秒的時間量 10s 通知遺漏原廠配置之前的等待時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 - classloading
- 廣域類別載入
屬性名稱 資料類型 預設值 說明 useJarUrls boolean false 要使用 jar: 或 wsjar: URL 來參照保存檔中的檔案 - enterpriseApplication
- 定義企業應用程式的內容。
屬性名稱 資料類型 預設值 說明 autoStart boolean true 指出伺服器是否自動啟動應用程式。 defaultClientModule string 企業應用程式的預設用戶端模組。 id string 唯一的配置 ID。 location 檔案、目錄或 URL。 應用程式的位置,以伺服器層次應用程式目錄的絕對路徑或相對路徑表示。 name string 應用程式的名稱。 suppressUncoveredHttpMethodWarning boolean false 在應用程式部署期間用來暫停未涵蓋的 HTTP 方法警告訊息的選項。 - enterpriseApplication > application-bnd
說明: 將應用程式中所包含的一般部署資訊連結到特定的資源。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 version string 應用程式連結規格的版本。 - enterpriseApplication > application-bnd > security-role
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name string 安全角色的名稱。 - enterpriseApplication > application-bnd > security-role > group
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 access-id string 群組存取 ID id string 唯一的配置 ID。 name string 佔有安全角色的群組名稱。
- enterpriseApplication > application-bnd > security-role > run-as
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 password 可逆的編碼密碼(字串) 從一個 Bean 存取另一個 Bean 所需的使用者密碼。其值可以用明碼或編碼形式儲存。如果要將密碼編碼,請搭配使用 securityUtility 工具與編碼選項。 userid string 從一個 Bean 存取另一個 Bean 所需的使用者 ID。
- enterpriseApplication > classloader
說明: 定義應用程式類別載入器的設定。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 classProviderRef 最上層 resourceAdapter 元素的參照清單(逗點區隔的字串)。 類別提供者參照清單。當搜尋類別或資源時,這個類別載入器會搜尋其本身的類別路徑,之後委派給指定的類別提供者。 commonLibraryRef 最上層 library 元素的參照清單(逗點區隔的字串)。 程式庫參照的清單。會與其他類別載入器共用程式庫類別實例。 delegation - parentFirst
- parentLast
parentFirst 控制在這個類別載入器之前或之後是否使用母項類別載入器。如果選取母項優先,則會先委派給原生母項,再搜尋類別路徑。如果選取母項最後,則會先搜尋類別路徑,再委派給原生母項。 - parentFirst
- 母項優先
- parentLast
- 母項最後
privateLibraryRef 最上層 library 元素的參照清單(逗點區隔的字串)。 程式庫參照的清單。程式庫類別實例是此類別載入器所特有,不依賴其他類別載入器的類別實例。 - enterpriseApplication > classloader > commonLibrary
說明: 程式庫參照的清單。會與其他類別載入器共用程式庫類別實例。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 description string 管理者的共用程式庫說明 filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。 參照的檔案集 ID id string 唯一的配置 ID。 name string 管理者的共用程式庫名稱 - enterpriseApplication > classloader > commonLibrary > file
說明: 參照的檔案 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name 檔案的路徑 完整檔名
- enterpriseApplication > classloader > commonLibrary > fileset
說明: 參照的檔案集 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。 dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。 excludes string 要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。 id string 唯一的配置 ID。 includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。 scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
- enterpriseApplication > classloader > privateLibrary
說明: 程式庫參照的清單。程式庫類別實例是此類別載入器所特有,不依賴其他類別載入器的類別實例。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 description string 管理者的共用程式庫說明 filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。 參照的檔案集 ID id string 唯一的配置 ID。 name string 管理者的共用程式庫名稱 - enterpriseApplication > classloader > privateLibrary > file
說明: 參照的檔案 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name 檔案的路徑 完整檔名
- enterpriseApplication > classloader > privateLibrary > fileset
說明: 參照的檔案集 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。 dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。 excludes string 要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。 id string 唯一的配置 ID。 includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。 scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
- enterpriseApplication > resourceAdapter
說明: 指定內嵌在應用程式中的資源配接器的配置。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 alias string ${id} 置換資源配接器的預設 ID。資源配接器的配置內容元素名稱中會使用 ID,進而用來判定資源配接器提供之任何資源的配置內容元素名稱。資源配接器的配置內容元素名稱的格式是 properties.<APP_NAME>.<ALIAS>,其中 <APP_NAME> 是應用程式名稱,<ALIAS> 是所配置的別名。如果沒有指定,會將別名預設為資源配接器的模組名稱。 autoStart boolean 配置一旦部署資源配接器就自動啟動資源配接器,或是延緩到注入或查閱資源時才啟動。 contextServiceRef 最上層 contextService 元素的參照(字串)。 配置如何擷取環境定義並延伸到執行緒。 id string 識別要套用這項配置之內嵌資源配接器模組的名稱。 - enterpriseApplication > resourceAdapter > contextService
說明: 配置如何擷取環境定義並延伸到執行緒。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- enterpriseApplication > resourceAdapter > contextService > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 id string 唯一的配置 ID。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- enterpriseApplication > resourceAdapter > contextService > baseContext > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: com.ibm.ws.context.service-factory
- enterpriseApplication > resourceAdapter > contextService > baseContext > classloaderContext
說明: 類別載入器環境定義延伸的配置。必要: false資料類型:
- enterpriseApplication > resourceAdapter > contextService > baseContext > jeeMetadataContext
說明: 將提交環境定義作業之應用程式元件的名稱空間提供給作業。必要: false資料類型:
- enterpriseApplication > resourceAdapter > contextService > baseContext > securityContext
說明: 當指定此項時,會將工作起始器的安全環境定義延伸到工作單元。必要: false資料類型:
- enterpriseApplication > resourceAdapter > contextService > baseContext > syncToOSThreadContext
說明: 當指定時,工作單元的 runAs 主題身分會與作業系統身分同步化。必要: false資料類型:
- enterpriseApplication > resourceAdapter > contextService > baseContext > zosWLMContext
說明: 指出「z/OS WLM 環境定義」應納入執行緒環境定義中一起管理。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 daemonTransactionClass string ASYNCDMN 當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 defaultTransactionClass string ASYNCBN 當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 wlm - Propagate
- PropagateOrNew
- New
Propagate 指出應如何處理「非常駐程式」工作的 WLM 環境定義。 - Propagate
- 使用相同的 WLM 環境定義(若有的話)。
- PropagateOrNew
- 使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。
- New
- 一律建立新的 WLM 環境定義。
- enterpriseApplication > resourceAdapter > contextService > classloaderContext
說明: 類別載入器環境定義延伸的配置。必要: false資料類型:
- enterpriseApplication > resourceAdapter > contextService > jeeMetadataContext
說明: 將提交環境定義作業之應用程式元件的名稱空間提供給作業。必要: false資料類型:
- enterpriseApplication > resourceAdapter > contextService > securityContext
說明: 當指定此項時,會將工作起始器的安全環境定義延伸到工作單元。必要: false資料類型:
- enterpriseApplication > resourceAdapter > contextService > syncToOSThreadContext
說明: 當指定時,工作單元的 runAs 主題身分會與作業系統身分同步化。必要: false資料類型:
- enterpriseApplication > resourceAdapter > contextService > zosWLMContext
說明: 指出「z/OS WLM 環境定義」應納入執行緒環境定義中一起管理。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 daemonTransactionClass string ASYNCDMN 當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 defaultTransactionClass string ASYNCBN 當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 wlm - Propagate
- PropagateOrNew
- New
Propagate 指出應如何處理「非常駐程式」工作的 WLM 環境定義。 - Propagate
- 使用相同的 WLM 環境定義(若有的話)。
- PropagateOrNew
- 使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。
- New
- 一律建立新的 WLM 環境定義。
- enterpriseApplication > resourceAdapter > customize
說明: 針對使用指定介面及/或實作類別的啟動規格、受管理物件或 Connection Factory,自訂其配置內容元素。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 implementation string 應自訂其配置內容元素的實作類別完整名稱。 interface string 應自訂其配置內容元素的介面類別完整名稱。 suffix string 置換配置內容元素的預設字尾。例如,properties.rarModule1.CustomConnectionFactory 中的 "CustomConnectionFactory"。當資源配接器提供了多種類型的 Connection Factory、受管理物件或端點啟動時,使用字尾有助於釐清。如果在自訂配置內容元素時省略了字尾或將它留白,則不會使用字尾。
- httpAccessLogging
- HTTP 存取日誌包含所有入埠 HTTP 用戶端要求的記錄。
屬性名稱 資料類型 預設值 說明 enabled boolean true 啟用存取記載。 filePath 檔案的路徑 ${server.output.dir}/logs/http_access.log 存取日誌檔的目錄路徑和名稱。指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。 id string 唯一的配置 ID。 logFormat string %h %u %{t}W "%r" %s %b 指定記載用戶端存取資訊時要使用的日誌格式。 maxFileSize int 下限:0
20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。 maxFiles int 下限:0
2 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。 - httpDispatcher
- 「HTTP 分派器」配置。
屬性名稱 資料類型 預設值 說明 appOrContextRootMissingMessage string 找不到所要求的 URI 中的應用程式時要傳回用戶端的訊息。 enableWelcomePage boolean true 當沒有應用程式連結至環境定義根目錄 "/" 時,則啟用預設的 Liberty 設定檔歡迎使用頁面。預設值為 true。 - httpEncoding
- HTTP 傳輸編碼設定
屬性名稱 資料類型 預設值 說明 converter.Big5 string Cp950 Big5 中文轉換器 converter.EUC-JP string Cp33722C EUC 日文轉換器 (EUC-JP) converter.EUC-KR string Cp970 EUC 韓文轉換器 (EUC-KR) converter.EUC-TW string Cp964 EUC 中文(台灣)轉換器 (EUC-TW) converter.EUC_KR string Cp970 EUC 韓文轉換器 (EUC_KR) converter.GB2312 string EUC_CN GB2312 中文轉換器 converter.ISO-2022-KR string ISO2022KR ISO-2022 韓文轉換器 (ISO-2022-KR) converter.Shift_JIS string Cp943C Shift_JIS 日文轉換器 encoding.ar string ISO-8859-6 阿拉伯文語言編碼 (ar) encoding.be string ISO-8859-5 白俄羅斯文語言編碼 (be) encoding.bg string ISO-8859-5 保加利亞文語言編碼 (bg) encoding.bn string UTF-8 孟加拉文語言編碼 (bn) encoding.ca string ISO-8859-1 加泰蘭文語言編碼 (ca) encoding.cs string ISO-8859-2 捷克文語言編碼 (cs) encoding.da string ISO-8859-1 丹麥文語言編碼 (da) encoding.de string ISO-8859-1 德文語言編碼 (de) encoding.el string ISO-8859-7 希臘文語言編碼 (el) encoding.en string ISO-8859-1 英文語言編碼 (en) encoding.es string ISO-8859-1 西班牙文語言編碼 (es) encoding.et string ISO-8859-4 愛沙尼亞文語言編碼 (et) encoding.eu string ISO-8859-1 巴斯克文語言編碼 (eu) encoding.fa string ISO-8859-6 波斯文語言編碼 (fa) encoding.fi string ISO-8859-1 芬蘭文語言編碼 (fi) encoding.fo string ISO-8859-2 法羅文語言編碼 (fo) encoding.fr string ISO-8859-1 法文語言編碼 (fr) encoding.he string ISO-8859-8 希伯來文語言編碼 (he) encoding.hi string UTF-8 北印度文語言編碼 (hi) encoding.hr string ISO-8859-2 克羅埃西亞文語言編碼 (hr) encoding.hu string ISO-8859-2 匈牙利文語言編碼 (hu) encoding.hy string UTF-8 亞美尼亞文語言編碼 (hy) encoding.is string ISO-8859-1 冰島文語言編碼 (is) encoding.it string ISO-8859-1 義大利文語言編碼 (it) encoding.iw string ISO-8859-8 希伯來文語言編碼 (iw) encoding.ja string Shift_JIS 日文語言編碼 (ja) encoding.ji string ISO-8859-8 意第緒文語言編碼 (ji) encoding.ka string UTF-8 喬治亞文語言編碼 (ka) encoding.ko string EUC-KR 韓文語言編碼 (ko) encoding.lt string ISO-8859-2 立陶宛文語言編碼 (lt) encoding.lv string ISO-8859-4 拉脫維亞文語言編碼 (lv) encoding.mk string ISO-8859-5 馬其頓文語言編碼 (mk) encoding.mr string UTF-8 馬拉地文語言編碼 (mr) encoding.ms string ISO-8859-6 馬來文語言編碼 (ms) encoding.mt string ISO-8859-3 馬爾他文語言編碼 (mt) encoding.nl string ISO-8859-1 荷蘭文語言編碼 (nl) encoding.no string ISO-8859-1 挪威文語言編碼 (no) encoding.pl string ISO-8859-2 波蘭文語言編碼 (pl) encoding.pt string ISO-8859-1 葡萄牙文語言編碼 (pt) encoding.ro string ISO-8859-2 羅馬尼亞文語言編碼 (ro) encoding.ru string ISO-8859-5 俄文語言編碼 (ru) encoding.sa string UTF-8 梵文語言編碼 (sa) encoding.sh string ISO-8859-2 塞爾維亞-克羅地亞文語言編碼 (sh) encoding.sk string ISO-8859-2 斯洛伐克文語言編碼 (sk) encoding.sl string ISO-8859-2 斯洛維尼亞文語言編碼 (sl) encoding.sq string ISO-8859-2 阿爾巴尼亞文語言編碼 (sq) encoding.sr string ISO-8859-5 塞爾維亞文語言編碼 (sr) encoding.sv string ISO-8859-1 瑞典文語言編碼 (sv) encoding.ta string UTF-8 泰米爾文語言編碼 (ta) encoding.th string windows-874 泰文語言編碼 (th) encoding.tr string ISO-8859-9 土耳其文語言編碼 (tr) encoding.uk string ISO-8859-5 烏克蘭文語言編碼 (uk) encoding.vi string windows-1258 越南文語言編碼 (vi) encoding.yi string ISO-8859-8 意第緒文語言編碼 (yi) encoding.zh string GB2312 中文語言編碼 (zh) encoding.zh_TW string Big5 中文語言編碼 (zh_TW) - httpEndpoint
- HTTP 端點的配置內容。
屬性名稱 資料類型 預設值 說明 accessLoggingRef 最上層 httpAccessLogging 元素的參照(字串)。 端點的 HTTP 存取記載配置。 enabled boolean true 切換此端點的可用性。如果是 true,分派器便會啟動這個端點來處理 HTTP 要求。 host string localhost 用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只是 DNS 主機名稱。使用 '*' 來代表所有可用網路介面。 httpOptionsRef 最上層 httpOptions 元素的參照(字串)。 defaultHttpOptions 端點的 HTTP 通訊協定選項。 httpPort int 下限:-1
上限:65535
用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 httpsPort int 下限:-1
上限:65535
受到 SSL (https) 保護的用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 id string 唯一的配置 ID。 onError - IGNORE
- FAIL
- WARN
WARN 無法啟動端點之後要採取的動作。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
sslOptionsRef 最上層 sslOptions 元素的參照(字串)。 端點的 SSL 通訊協定選項。 tcpOptionsRef 最上層 tcpOptions 元素的參照(字串)。 defaultTCPOptions 端點的 TCP 通訊協定選項。 - httpEndpoint > accessLogging
說明: 端點的 HTTP 存取記載配置。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 enabled boolean true 啟用存取記載。 filePath 檔案的路徑 ${server.output.dir}/logs/http_access.log 存取日誌檔的目錄路徑和名稱。指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。 logFormat string %h %u %{t}W "%r" %s %b 指定記載用戶端存取資訊時要使用的日誌格式。 maxFileSize int 下限:0
20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。 maxFiles int 下限:0
2 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。
- httpEndpoint > httpOptions
說明: 端點的 HTTP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 keepAliveEnabled boolean 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 boolean false 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。 writeTimeout 精準度是秒鐘的時間量 60s 在 Socket 上等待傳輸每部分回應資料的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
- httpEndpoint > sslOptions
說明: 端點的 SSL 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 sessionTimeout 精準度是秒鐘的時間量 1d 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 sslRef string 預設 SSL 配置儲存庫。預設值是 defaultSSLSettings。 suppressHandshakeErrors boolean false 停用 SSL 信號交換記載錯誤。在正常作業期間可能會發生 SSL 信號交換錯誤,不過當 SSL 的行為並非所預期時,這些訊息可能會非常有用。
- httpEndpoint > tcpOptions
說明: 端點的 TCP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 inactivityTimeout 精準度是毫秒的時間量 60s 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 soReuseAddr boolean true 啟用立即重新連結至沒有作用中接聽器的埠。
- httpOptions
- HTTP 通訊協定配置。
屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 keepAliveEnabled boolean 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 boolean false 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。 writeTimeout 精準度是秒鐘的時間量 60s 在 Socket 上等待傳輸每部分回應資料的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 - httpProxyRedirect
- 配置埠重新導向。將 HTTP 要求從非安全埠(例如 80)重新導向至啟用 SSL 的安全埠(例如 443)時,使用「HTTP Proxy 重新導向」。
屬性名稱 資料類型 預設值 說明 enabled boolean true 這個屬性決定伺服器是否應重新導向這個配置元素中指定的埠。預設值是 true。 host string * 重新導向此埠時,要使用的主機名稱。送入的要求所指定的主機名稱必須符合此值,伺服器才會重新導向 HTTP 要求。預設值是 *(所有主機)。 httpPort int 下限:1
上限:65535
重新導向時的來源(非安全)埠。此埠上送入的 HTTP 要求會重新導向至指定的 HTTPS 埠。 httpsPort int 下限:1
上限:65535
重新導向時的目標(安全)埠。使用 HTTP 埠之送入的 HTTP 要求會重新導向至這個埠。 id string 唯一的配置 ID。 - httpSession
- HTTP 階段作業管理的配置。
屬性名稱 資料類型 預設值 說明 allowOverflow boolean true 容許記憶體內的階段作業數目可以超出「記憶體內階段作業數目上限」內容的值。 alwaysEncodeUrl boolean false Servlet 2.5 規格指定不將 response.encodeURL 呼叫上的 URL 編碼(如果非必要的話)。如果要在已啟用 URL 編碼時支援舊版相容性,請將這個內容設定為 true 以呼叫 encodeURL 方法。即使瀏覽器支援 Cookie,也一律會將 URL 編碼。 cloneId string 叢集成員的複本 ID。在叢集內,這個 ID 必須是唯一的,才能保持階段作業親緣性。當設定時,這個名稱會改寫伺服器所產生的預設名稱。 cloneSeparator string : 用來將階段作業 ID 與階段作業 Cookie 中的複本 ID 分隔的單一字元。通常應使用預設值。在某些「無線應用程式通訊協定 (WAP)」裝置上,並不容許冒號 (:),因此應改為使用加號 (+)。請少用不同的值。在使用這個內容來變更複本分隔字元之前,您應先瞭解在您系統上執行的其他產品之複本字元需求。您可以將任何字元指定為這個內容的值,這並不默示您指定的字元都能夠正確運作。這項事實也不默示 IBM 要負責修正使用替代字元所可能引起的任何問題。 cookieDomain string 階段作業追蹤 Cookie 的網域欄位。 cookieHttpOnly boolean true 指定階段作業 Cookie 是否包含 HttpOnly 欄位。支援 HttpOnly 欄位的瀏覽器不會讓用戶端 Script 可以存取 Cookie。使用 HttpOnly 欄位將有助於防止跨網站 Script 攻擊。 cookieMaxAge 精準度是秒鐘的時間量 -1 Cookie 可以位於用戶端瀏覽器上的時間量上限。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 cookieName string JSESSIONID 階段作業管理 Cookie 的唯一名稱。 cookiePath string / Cookie 會傳送至路徑中指定的 URL。 cookieSecure boolean false 指定階段作業 Cookie 是否包含安全欄位。 cookiesEnabled boolean true 指定階段作業追蹤利用 Cookie 來傳送階段作業 ID。 debugCrossover boolean false 啟用這個選項可執行附加的檢查,以確認只有存取或參照與要求相關聯的階段作業,以及日誌訊息(如果偵測到任何不相符)。停用這個選項可跳過附加檢查。 forceInvalidationMultiple int 3 如果您的要求通常不受限於回應時間限制,請指定 0 來指出階段作業管理程式在試圖使階段作業失效之前,應無限期等待直到要求完成。否則,請將這個內容設定為正整數,以延遲讓作用中階段作業失效。作用中的逾時階段作業將不會因第一個失效間隔傳遞而失效,但是將會根據此值的間隔傳遞而失效。例如,值 2 會在階段作業逾時值過期之後,使第二個失效間隔傳遞上的作用中階段作業失效。 idLength int 23 階段作業 ID 的長度。 idReuse boolean false 在未配置階段作業持續存在的多重 JVM 環境中,將這個內容設定為 "true" 會讓階段作業管理程式能夠對所有使用者的要求使用相同的階段作業資訊,即使處理這些要求的 Web 應用程式是由不同的 JVM 所控管亦然。這個內容的預設值為 false。如果您要讓階段作業管理程式能夠使用瀏覽器傳送的階段作業 ID,以在未配置階段作業持續存在的環境所執行的 Web 應用程式之間保留階段作業資料,請將這個內容設定為 true。 invalidateOnUnauthorizedSessionRequestException boolean false 對於回應未獲授權的要求,如果您希望階段作業管理程式讓階段作業失效,請將此內容設為 true,而不是發出 UnauthorizedSessionRequestException。當階段作業失效時,要求端可以建立新的階段作業,但是不能存取任何先前儲存的階段作業資料。這可讓單一使用者在登出之後,可繼續處理對其他應用程式的要求,而且又能保護階段作業資料。 invalidationTimeout 精準度是秒鐘的時間量 30m 階段作業在失效之前可保持未使用的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 maxInMemorySessionCount int 1000 針對每個 Web 模組在記憶體內維護的階段作業數目上限。 noAdditionalInfo boolean false 強制移除在階段作業 ID 中不需要的資訊。 protocolSwitchRewritingEnabled boolean false 當 URL 需要從 HTTP 切換至 HTTPS 或從 HTTPS 切換至 HTTP 時,將階段作業 ID 新增至 URL 中。 reaperPollInterval 精準度是秒鐘的時間量 -1 移除無效階段作業之程序的起動間隔(以秒為單位)。下限值為 30 秒。如果輸入小於下限的值,會自動判定並使用適當的值。這個值會根據階段作業逾時值來置換預設安裝值,其介於 30 到 360 秒之間。由於預設階段作業逾時值是 30 分鐘,因此收割者間隔通常是介於 2 到 3 分鐘之間。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 rewriteId string jsessionid 請使用這個內容來變更與 URL 重新編寫一起使用的索引鍵。 securityIntegrationEnabled boolean true 啟用安全整合,其會導致階段作業管理機能建立使用者身分與其 HTTP 階段作業的關聯性。 securityUserIgnoreCase boolean false 指出即使階段作業安全身分和用戶端安全身分的大小寫不同,它們也應視為相符。例如,當這個內容設定為 true 時,階段作業安全身分 USER1 符合用戶端安全身分 User1 和 user1。 sslTrackingEnabled boolean false 指定階段作業追蹤利用 Secure Sockets Layer (SSL) 資訊來作為階段作業 ID。 urlRewritingEnabled boolean false 指定階段作業管理機能利用重新編寫的 URL 來傳送階段作業 ID。 useContextRootAsCookiePath boolean false 指明 Cookie 路徑等於 Web 模組的環境定義根目錄,而不是 / - javaPermission
- Java 2 安全的權限配置。
屬性名稱 資料類型 預設值 說明 actions string 許可權授與容許對目標名稱執行的動作。例如,以 java.io.FilePermission 來說,是「讀取」。 className string 實作要授與之許可權的類別名稱。例如 java.io.FilePermission。 codebase string 要被授予該權限的程式碼庫。 id string 唯一的配置 ID。 name string 要套用許可權的目標。例如,以 java.io.FilePermission 來說,是「所有檔案」。 principalName string 要被授予權限的主體。 principalType string 要針對給定主體名稱進行比對的類別名稱。 restriction boolean false 宣告是限制或授與許可權。如果限制設為 "true",則是拒絕而非授與此許可權。 - library
- 共用程式庫
屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 description string 管理者的共用程式庫說明 filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。 參照的檔案集 ID id string 唯一的配置 ID。 name string 管理者的共用程式庫名稱 - library > fileset
說明: 參照的檔案集 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。 dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。 excludes string 要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。 id string 唯一的配置 ID。 includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。 scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
- mimeTypes
- 所有 HTTP 虛擬主機共用的 MIME 類型定義
- pluginConfiguration
- 產生外掛程式配置
屬性名稱 資料類型 預設值 說明 connectTimeout 精準度是秒鐘的時間量 5s 識別應用程式伺服器應維護 Web 伺服器連線的時間量上限。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 extendedHandshake boolean false 若為 true,Web 伺服器外掛程式會使用延伸信號交換,來判斷應用程式伺服器是否正在執行。 httpEndpointRef 最上層 httpEndpoint 元素的參照(字串)。 defaultHttpEndpoint 指定 http 端點的 ID 以併入產生的 plugin-cfg.xml 檔。端點定義叢集中的伺服器。預設值是 'defaultHttpEndpoint'。 ipv6Preferred boolean false 偏好 IPv6 logDirLocation 目錄的路徑 識別 http_plugin.log 檔所在的目錄。 pluginInstallRoot string . Web 儲存器外掛程式在檔案系統中的安裝位置 serverIOTimeout 精準度是秒鐘的時間量 900s 識別 Web 伺服器外掛程式在傳送要求或接收應用程式伺服器的回應時,應等待的時間量上限。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 sslCertlabel string LibertyCert SSL 憑證標籤 sslKeyringLocation string keyring.kdb SSL 金鑰環的位置 sslStashfileLocation string keyring.sth SSL 隱藏檔的位置 waitForContinue boolean false 若為 false(預設值),Web 伺服器外掛程式在傳送含有訊息內文的 HTTP 要求時,會包含 "Expect: 100-continue" 標頭。如果設為 true,Web 伺服器外掛程式在傳送每一項 HTTP 要求時,都會包含 "Expect: 100-continue" 標頭。如果 Web 伺服器和應用程式伺服器之間存在防火牆,且動輒因沒有要求內容而重試要求,請考量將此值設為 true。 webserverPort int 下限:-1
上限:65535
80 Web 伺服器 HTTP 埠 webserverSecurePort int 下限:-1
上限:65535
443 Web 伺服器 HTTPS 埠 wsServerIOTimeout 精準度是秒鐘的時間量 識別 Web 伺服器外掛程式在傳送要求或接收應用程式伺服器的 WebSocket 回應時,應等待的時間量上限。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 wsServerIdleTimeout 精準度是秒鐘的時間量 識別當終止閒置的 WebSocket 連線時,Web 伺服器外掛程式要等待的時間量上限。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 - pluginConfiguration > httpEndpoint
說明: 指定 http 端點的 ID 以併入產生的 plugin-cfg.xml 檔。端點定義叢集中的伺服器。預設值是 'defaultHttpEndpoint'。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 accessLoggingRef 最上層 httpAccessLogging 元素的參照(字串)。 端點的 HTTP 存取記載配置。 enabled boolean true 切換此端點的可用性。如果是 true,分派器便會啟動這個端點來處理 HTTP 要求。 host string localhost 用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只是 DNS 主機名稱。使用 '*' 來代表所有可用網路介面。 httpOptionsRef 最上層 httpOptions 元素的參照(字串)。 defaultHttpOptions 端點的 HTTP 通訊協定選項。 httpPort int 下限:-1
上限:65535
用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 httpsPort int 下限:-1
上限:65535
受到 SSL (https) 保護的用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 onError - IGNORE
- FAIL
- WARN
WARN 無法啟動端點之後要採取的動作。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
sslOptionsRef 最上層 sslOptions 元素的參照(字串)。 端點的 SSL 通訊協定選項。 tcpOptionsRef 最上層 tcpOptions 元素的參照(字串)。 defaultTCPOptions 端點的 TCP 通訊協定選項。 - pluginConfiguration > httpEndpoint > accessLogging
說明: 端點的 HTTP 存取記載配置。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 enabled boolean true 啟用存取記載。 filePath 檔案的路徑 ${server.output.dir}/logs/http_access.log 存取日誌檔的目錄路徑和名稱。指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。 logFormat string %h %u %{t}W "%r" %s %b 指定記載用戶端存取資訊時要使用的日誌格式。 maxFileSize int 下限:0
20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。 maxFiles int 下限:0
2 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。
- pluginConfiguration > httpEndpoint > httpOptions
說明: 端點的 HTTP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 keepAliveEnabled boolean 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 boolean false 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。 writeTimeout 精準度是秒鐘的時間量 60s 在 Socket 上等待傳輸每部分回應資料的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
- pluginConfiguration > httpEndpoint > sslOptions
說明: 端點的 SSL 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 sessionTimeout 精準度是秒鐘的時間量 1d 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 sslRef string 預設 SSL 配置儲存庫。預設值是 defaultSSLSettings。 suppressHandshakeErrors boolean false 停用 SSL 信號交換記載錯誤。在正常作業期間可能會發生 SSL 信號交換錯誤,不過當 SSL 的行為並非所預期時,這些訊息可能會非常有用。
- pluginConfiguration > httpEndpoint > tcpOptions
說明: 端點的 TCP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 inactivityTimeout 精準度是毫秒的時間量 60s 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 soReuseAddr boolean true 啟用立即重新連結至沒有作用中接聽器的埠。
- tcpOptions
- 定義 TCP 通訊協定設定。
屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 inactivityTimeout 精準度是毫秒的時間量 60s 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 soReuseAddr boolean true 啟用立即重新連結至沒有作用中接聽器的埠。 - virtualHost
- 虛擬主機提供邏輯分組,可將 Web 應用程式配置成特定主機名稱。預設虛擬主機 (default_host) 適用於大部分簡易的配置。
屬性名稱 資料類型 預設值 說明 allowFromEndpointRef 最上層 httpEndpoint 元素的參照清單(逗點區隔的字串)。 指定一或多個 HTTP 端點的 ID,以限制虛擬主機只接受來自指定端點的入埠資料流量。 enabled boolean true 啟用這個虛擬主機。 id string 唯一的配置 ID。 - virtualHost > allowFromEndpoint
說明: 指定一或多個 HTTP 端點的 ID,以限制虛擬主機只接受來自指定端點的入埠資料流量。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 accessLoggingRef 最上層 httpAccessLogging 元素的參照(字串)。 端點的 HTTP 存取記載配置。 enabled boolean true 切換此端點的可用性。如果是 true,分派器便會啟動這個端點來處理 HTTP 要求。 host string localhost 用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只是 DNS 主機名稱。使用 '*' 來代表所有可用網路介面。 httpOptionsRef 最上層 httpOptions 元素的參照(字串)。 defaultHttpOptions 端點的 HTTP 通訊協定選項。 httpPort int 下限:-1
上限:65535
用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 httpsPort int 下限:-1
上限:65535
受到 SSL (https) 保護的用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 id string 唯一的配置 ID。 onError - IGNORE
- FAIL
- WARN
WARN 無法啟動端點之後要採取的動作。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
sslOptionsRef 最上層 sslOptions 元素的參照(字串)。 端點的 SSL 通訊協定選項。 tcpOptionsRef 最上層 tcpOptions 元素的參照(字串)。 defaultTCPOptions 端點的 TCP 通訊協定選項。 - virtualHost > allowFromEndpoint > accessLogging
說明: 端點的 HTTP 存取記載配置。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 enabled boolean true 啟用存取記載。 filePath 檔案的路徑 ${server.output.dir}/logs/http_access.log 存取日誌檔的目錄路徑和名稱。指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。 logFormat string %h %u %{t}W "%r" %s %b 指定記載用戶端存取資訊時要使用的日誌格式。 maxFileSize int 下限:0
20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。 maxFiles int 下限:0
2 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。
- virtualHost > allowFromEndpoint > httpOptions
說明: 端點的 HTTP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 keepAliveEnabled boolean 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 boolean false 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。 writeTimeout 精準度是秒鐘的時間量 60s 在 Socket 上等待傳輸每部分回應資料的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
- virtualHost > allowFromEndpoint > sslOptions
說明: 端點的 SSL 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 sessionTimeout 精準度是秒鐘的時間量 1d 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 sslRef string 預設 SSL 配置儲存庫。預設值是 defaultSSLSettings。 suppressHandshakeErrors boolean false 停用 SSL 信號交換記載錯誤。在正常作業期間可能會發生 SSL 信號交換錯誤,不過當 SSL 的行為並非所預期時,這些訊息可能會非常有用。
- virtualHost > allowFromEndpoint > tcpOptions
說明: 端點的 TCP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 inactivityTimeout 精準度是毫秒的時間量 60s 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 soReuseAddr boolean true 啟用立即重新連結至沒有作用中接聽器的埠。
- webApplication
- 定義 Web 應用程式的內容。
屬性名稱 資料類型 預設值 說明 autoStart boolean true 指出伺服器是否自動啟動應用程式。 contextRoot string 應用程式的環境定義根目錄。 id string 唯一的配置 ID。 location 檔案、目錄或 URL。 應用程式的位置,以伺服器層次應用程式目錄的絕對路徑或相對路徑表示。 name string 應用程式的名稱。 suppressUncoveredHttpMethodWarning boolean false 在應用程式部署期間用來暫停未涵蓋的 HTTP 方法警告訊息的選項。 - webApplication > application-bnd
說明: 將應用程式中所包含的一般部署資訊連結到特定的資源。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 version string 應用程式連結規格的版本。 - webApplication > application-bnd > security-role
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name string 安全角色的名稱。 - webApplication > application-bnd > security-role > group
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 access-id string 群組存取 ID id string 唯一的配置 ID。 name string 佔有安全角色的群組名稱。
- webApplication > application-bnd > security-role > run-as
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 password 可逆的編碼密碼(字串) 從一個 Bean 存取另一個 Bean 所需的使用者密碼。其值可以用明碼或編碼形式儲存。如果要將密碼編碼,請搭配使用 securityUtility 工具與編碼選項。 userid string 從一個 Bean 存取另一個 Bean 所需的使用者 ID。
- webApplication > classloader
說明: 定義應用程式類別載入器的設定。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 classProviderRef 最上層 resourceAdapter 元素的參照清單(逗點區隔的字串)。 類別提供者參照清單。當搜尋類別或資源時,這個類別載入器會搜尋其本身的類別路徑,之後委派給指定的類別提供者。 commonLibraryRef 最上層 library 元素的參照清單(逗點區隔的字串)。 程式庫參照的清單。會與其他類別載入器共用程式庫類別實例。 delegation - parentFirst
- parentLast
parentFirst 控制在這個類別載入器之前或之後是否使用母項類別載入器。如果選取母項優先,則會先委派給原生母項,再搜尋類別路徑。如果選取母項最後,則會先搜尋類別路徑,再委派給原生母項。 - parentFirst
- 母項優先
- parentLast
- 母項最後
privateLibraryRef 最上層 library 元素的參照清單(逗點區隔的字串)。 程式庫參照的清單。程式庫類別實例是此類別載入器所特有,不依賴其他類別載入器的類別實例。 - webApplication > classloader > commonLibrary
說明: 程式庫參照的清單。會與其他類別載入器共用程式庫類別實例。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 description string 管理者的共用程式庫說明 filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。 參照的檔案集 ID id string 唯一的配置 ID。 name string 管理者的共用程式庫名稱 - webApplication > classloader > commonLibrary > file
說明: 參照的檔案 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name 檔案的路徑 完整檔名
- webApplication > classloader > commonLibrary > fileset
說明: 參照的檔案集 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。 dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。 excludes string 要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。 id string 唯一的配置 ID。 includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。 scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
- webApplication > classloader > privateLibrary
說明: 程式庫參照的清單。程式庫類別實例是此類別載入器所特有,不依賴其他類別載入器的類別實例。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 description string 管理者的共用程式庫說明 filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。 參照的檔案集 ID id string 唯一的配置 ID。 name string 管理者的共用程式庫名稱 - webApplication > classloader > privateLibrary > file
說明: 參照的檔案 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name 檔案的路徑 完整檔名
- webApplication > classloader > privateLibrary > fileset
說明: 參照的檔案集 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。 dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。 excludes string 要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。 id string 唯一的配置 ID。 includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。 scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
- webContainer
- Web 儲存器的配置。
屬性名稱 資料類型 預設值 說明 allowExpressionFactoryPerApp boolean false 切換以載入應用程式設定的 ExpressionFactory。如果您要使用的自訂 EL 實作(例如 JUEL)需要設定自己的 ExpressionFactory,請啟用此自訂內容。 allowIncludeSendError boolean false 容許 RequestDispatch 傳送 Include 方法錯誤。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.allowincludesenderror。 asyncMaxSizeTaskPool int 5000 自動清除取消的作業之前,非同步作業儲存區中的作業大小上限。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.asyncmaxsizetaskpool。 asyncPurgeInterval int 30000 已取消的作業儲存區的每個必要清除之間所要等待的時間間隔。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.asyncpurgeinterval。 asyncTimeoutDefault int 30000 未明確指定逾時值時所用的非同步 Servlet 逾時值。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.asynctimeoutdefault。 asyncTimerThreads int 2 要用於非同步 Servlet 逾時處理的執行緒數目上限。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.asynctimerthreads。 channelWriteType string async 當設為「同步」時,會同步寫入回應;否則會非同步寫入回應。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.channelwritetype。 copyAttributesKeySet boolean false Web 儲存器會將屬性清單副本的列舉傳回 Servlet,以避免 Servlet 所造成的並行存取錯誤。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.copyattributeskeyset。 decodeUrlAsUtf8 boolean true 利用 UTF-8 的編碼設定來進行 URL 解碼 decodeUrlPlusSign boolean false 將屬於 URL 一部分的加號解碼。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.decodeurlplussign。 defaultHeadRequestBehavior boolean false 還原 HEAD 要求不受針對 GET 方法所定義之安全限制的行為。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.DefaultHeadRequestBehavior。 defaultTraceRequestBehavior boolean false 還原 HTTP TRACE 處理。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.DefaultTraceRequestBehavior。 deferServletLoad boolean true 延遲 Servlet 載入和起始設定,直到提出第一個要求為止。 deferServletRequestListenerDestroyOnError boolean false 當處理要求期間發生錯誤時,如果您想延遲毀損 ServletRequestListener,請切換這個選項。預設值是 false。在完整應用程式伺服器設定檔中,其對等自訂內容是 com.ibm.ws.webcontainer.deferServletRequestListenerDestroyOnError。 directoryBrowsingEnabled boolean false 啟用應用程式的目錄瀏覽。 disableXPoweredBy boolean false 停用設定 X-Powered-By 標頭。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.disablexpoweredby。 disallowAllFileServing boolean false 停用應用程式的所有檔案提供。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.disallowAllFileServing。 disallowServeServletsByClassName boolean true 不允許在應用程式伺服器層次使用 serveServletsByClassnameEnabled。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.disallowserveservletsbyclassname。 dispatcherRethrowsEr boolean true Web 儲存器會重新擲出錯誤,讓相關的資源處理它們。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.dispatcherRethrowser。 doNotServeByClassName string 完全不允許依類別名稱提供且以分號區隔的類別清單。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.donotservebyclassname。 emptyServletMappings boolean false 當未新增 Servlet 對映時,如果您想傳回空集合,而不是傳回空值,請切換這個選項。預設值是 false。在完整應用程式伺服器設定檔中,其對等自訂內容是 com.ibm.ws.webcontainer.emptyservletmappings。 enableDefaultIsElIgnoredInTag boolean false 一律評估是否忽略標籤檔中的 EL 表示式。如果母項 JSP 檔有不同的 isELIgnored 設定,就會在標籤檔中重新評估設定。在完整設定檔應用程式伺服器中,對等的自訂內容是 com.ibm.ws.jsp.enabledefaultiselignoredintag。 enableErrorExceptionTypeFirst boolean false Web 儲存器更新為先搜尋及使用異常狀況類型,再搜尋及使用錯誤碼。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.enableErrorExceptionTypeFirst。 enableJspMappingOverride boolean false 容許置換 JSP 對映,以便應用程式可以自行提供 JSP 內容。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.enablejspmappingoverride。 enableMultiReadOfPostData boolean false 保留 POST 資料以供多個讀取權使用。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.enablemultireadofpostdata。 exposeWebInfOnDispatch boolean false 若為 true,Servlet 便可存取 WEB-INF 目錄中的檔案。若為 false(預設值),Servlet 就無法存取 WEB-INF 目錄中的檔案。 fileServingEnabled boolean true 如果未對應用程式明確指定此設定,會啟用檔案提供。 fileWrapperEvents boolean false Web 儲存器在提供靜態檔案時會產生 SMF 和 PMI 資料。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.fileWrapperEvents。 httpsIndicatorHeader string 如果是 SSL 卸載,請設為 SSL 加速器/Proxy/負載平衡器所插入的 HTTP 標頭變數名稱。 ignoreSemiColonOnRedirectToWelcomePage boolean false 切換此項,以便在重新導向至歡迎使用頁面時,忽略尾端的分號。預設值是 false。在完整應用程式伺服器設定檔中,其對等自訂內容是 com.ibm.ws.webcontainer.ignoreSemiColonOnRedirectToWelcomePage。 ignoreSessiononStaticFileRequest boolean false 提高效能的方法為,防止 Web 儲存器存取涉及過濾器之靜態檔案要求的階段作業。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.IgnoreSessiononStaticFileRequest。 invokeFilterInitAtStartup boolean true Web 儲存器會在應用程式啟動時呼叫過濾器的 init() 方法。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.invokeFilterInitAtStartup。 listeners string 以逗點區隔的接聽器類別清單。 logServletContainerInitializerClassLoadingErrors boolean false 將 Servlet 儲存器類別載入錯誤記載為「警告」,而不只是在啟用除錯時記載它們。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.logservletcontainerinitializerclassloadingerrors。 metaInfResourcesCacheSize int 20 設定 meta-inf 資源快取的起始大小(項目數)。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.metainfresourcescachesize.name。 parseUtf8PostData boolean false Web 儲存器會偵測非 URL 編碼的 UTF-8 POST 資料,並將它併入參數值中。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.parseutf8postdata。 serveServletsByClassnameEnabled boolean false 如果未明確指定此設定,則可利用類別名稱在 Web 應用程式中存取 Servlet。 setContentLengthOnClose boolean true 當應用程式明確關閉回應時,切換成設定內容長度。預設值是 true;不過,如果應用程式的回應含有雙位元組字元,請將此值設為 false。 skipMetaInfResourcesProcessing boolean false 不要在 meta-inf 目錄中搜尋應用程式資源。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.skipmetainfresourcesprocessing。 suppressHtmlRecursiveErrorOutput boolean false 當有應用程式配置的錯誤頁面所無法處理的遞迴錯誤時,抑制 HTML 輸出顯示異常狀況資訊。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.suppressHtmlRecursiveErrorOutput。 symbolicLinksCacheSize int 1000 符號鏈結快取的起始大小。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.SymbolicLinksCacheSize。 tolerateSymbolicLinks boolean false 使 Web 儲存器能夠支援使用符號鏈結。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.TolerateSymbolicLinks。 useSemiColonAsDelimiterInURI boolean false 切換此項,以便在要求 URI 中使用分號作為定界字元。預設值是 false。在完整應用程式伺服器設定檔中,其對等自訂內容是 com.ibm.ws.webcontainer.useSemiColonAsDelimiterInURI。 xPoweredBy string X-Powered-By 標頭設定的替代字串。在完整應用程式伺服器設定檔中的對等自訂內容是 com.ibm.ws.webcontainer.xpoweredby。這個內容沒有預設值。如果未設定內容,X-Powered-By 標頭的值會設為 Servlet/<servlet 規格版本>,如 Servlet 規格所定義。