Java Servlets 3.0

這項特性支援將 HTTP Servlet 寫入至 Java Servlet 3.0 規格。Servlet 可以套裝在 Java EE 指定的 WAR 或 EAR 檔中。如果需要 Servlet 安全,也應該配置 appSecurity 特性;如果缺少安全特性,則會忽略應用程式的任何安全限制。

啟用這項特性

如果要啟用 Java Servlets 3.0 特性,請在 server.xml 檔的 featureManager 元素內,新增下列的元素宣告:
<feature>servlet-3.0</feature>

支援的 Java™ 版本

  • JavaSE-1.6
  • JavaSE-1.7
  • JavaSE-1.8

開發相依於這項特性的特性

如果您要開發的特性相依於 Java Servlets 3.0 特性,請將下列項目包含在您新特性的特性資訊清單檔 Subsystem-Content 標頭中:
com.ibm.websphere.appserver.servlet-3.0; type="osgi.subsystem.feature"

這項特性提供的標準 API 套件

  • javax.servlet
  • javax.servlet.annotation
  • javax.servlet.descriptor
  • javax.servlet.http
  • javax.servlet.resources

特性配置元素

您可以在 server.xml 檔中使用下列元素,來配置 Java Servlets 3.0 特性:

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 > application-bnd > security-role > special-subject
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
type
  • EVERYONE
  • ALL_AUTHENTICATED_USERS
  下列其中一種特殊主體類型:ALL_AUTHENTICATED_USERS、EVERYONE。
EVERYONE
每個人
ALL_AUTHENTICATED_USERS
所有已鑑別的使用者
application > application-bnd > security-role > user
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
access-id string   以一般格式 user:realmName/userUniqueId 表示的使用者存取 ID。如果未指定 ID,將會產生值。
id string   唯一的配置 ID。
name string   佔有安全角色的使用者名稱。
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 > commonLibrary > folder
說明:參照的資料夾 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併到程式庫類別路徑中以便尋找資源檔的目錄或資料夾
id string   唯一的配置 ID。
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 > classloader > privateLibrary > folder
說明:參照的資料夾 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併到程式庫類別路徑中以便尋找資源檔的目錄或資料夾
id string   唯一的配置 ID。
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 > application-bnd > security-role > special-subject
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
type
  • EVERYONE
  • ALL_AUTHENTICATED_USERS
  下列其中一種特殊主體類型:ALL_AUTHENTICATED_USERS、EVERYONE。
EVERYONE
每個人
ALL_AUTHENTICATED_USERS
所有已鑑別的使用者
enterpriseApplication > application-bnd > security-role > user
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
access-id string   以一般格式 user:realmName/userUniqueId 表示的使用者存取 ID。如果未指定 ID,將會產生值。
id string   唯一的配置 ID。
name string   佔有安全角色的使用者名稱。
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 > commonLibrary > folder
說明:參照的資料夾 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併到程式庫類別路徑中以便尋找資源檔的目錄或資料夾
id string   唯一的配置 ID。
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 > classloader > privateLibrary > folder
說明:參照的資料夾 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併到程式庫類別路徑中以便尋找資源檔的目錄或資料夾
id string   唯一的配置 ID。
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。
httpDispatcher > trustedHeaderOrigin
說明:Web 伺服器外掛程式使用私密標頭來提供原始要求的相關資訊。這些標頭優先於 http 主機標頭,用以選取虛擬主機來處理要求。預設值是 '*',表示信任任何來源送入的私密標頭。請指定 'none' 以停用私密標頭並只依賴 http 主機標頭,或指定 IP 位址清單,以限制只處理特定信任來源的私密標頭。
必要:false
資料類型:string
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 > file
說明:參照的檔案 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
name 檔案的路徑   完整檔名
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 秒。
library > folder
說明:參照的資料夾 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併到程式庫類別路徑中以便尋找資源檔的目錄或資料夾
id string   唯一的配置 ID。
mimeTypes
所有 HTTP 虛擬主機共用的 MIME 類型定義
mimeTypes > type
說明:MIME 類型的定義,形式為 id=value。副檔名為 id,關聯類型為 value。
必要:false
資料類型:string
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 啟用立即重新連結至沒有作用中接聽器的埠。
virtualHost > hostAlias
說明:使用 host:port 語法來建立主機和埠與此虛擬主機的關聯性。指定的主機可以是 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱、DNS 主機名稱,或 * 表示以萬用字元比對所有主機名稱。請注意,IPv6 位址必須以 [] 括住。
必要:false
資料類型:string
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 > application-bnd > security-role > special-subject
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
type
  • EVERYONE
  • ALL_AUTHENTICATED_USERS
  下列其中一種特殊主體類型:ALL_AUTHENTICATED_USERS、EVERYONE。
EVERYONE
每個人
ALL_AUTHENTICATED_USERS
所有已鑑別的使用者
webApplication > application-bnd > security-role > user
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
access-id string   以一般格式 user:realmName/userUniqueId 表示的使用者存取 ID。如果未指定 ID,將會產生值。
id string   唯一的配置 ID。
name string   佔有安全角色的使用者名稱。
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 > commonLibrary > folder
說明:參照的資料夾 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併到程式庫類別路徑中以便尋找資源檔的目錄或資料夾
id string   唯一的配置 ID。
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 秒。
webApplication > classloader > privateLibrary > folder
說明:參照的資料夾 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併到程式庫類別路徑中以便尋找資源檔的目錄或資料夾
id string   唯一的配置 ID。
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 規格所定義。

指示主題類型的圖示 參照主題

資訊中心條款 | 意見


「時間戳記」圖示 前次更新: 2015 年 6 月 22 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_feature_servlet-3.0
檔名:rwlp_feature_servlet-3.0.html