應用程式 (application)
定義應用程式的內容。
| 屬性名稱 | 資料類型 | 預設值 | 說明 |
|---|---|---|---|
| autoStart | 布林 | True | 指出伺服器是否自動啟動應用程式。 |
| 環境定義根目錄 | 字串 | 應用程式的環境定義根目錄。 | |
| id | 字串 | 唯一的配置 ID。 | |
| location | 檔案、目錄或 URL。 | 應用程式的位置,以絕對路徑或相對於伺服器層次應用程式目錄的路徑表示。 | |
| name | 字串 | 應用程式的名稱。 | |
| suppressUncoveredHttpMethodWarning | 布林 | false | 這個選項會在應用程式部署期間抑制所發現的 HTTP 方法警告訊息。 |
| type | 字串 | 應用程式保存檔的類型。 |
- application-bnd
說明: 將應用程式所包含的一般部署資訊連結到特定資源。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 version 字串 應用程式連結規格的版本。 - application-bnd > security-role
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id 字串 唯一的配置 ID。 name 字串 安全角色的名稱。 - application-bnd > security-role > group
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 access-id 字串 群組存取 ID id 字串 唯一的配置 ID。 name 字串 具備安全角色之群組的名稱。
- application-bnd > security-role > run-as
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id 字串 唯一的配置 ID。 password 可反向編碼的密碼(字串) 從一個 Bean 存取另一個 Bean 所需要的使用者密碼。 這個值可以用明碼或編碼的形式來儲存。 如果要將密碼編碼,請搭配 encode 選項來使用 securityUtility 工具。 userid 字串 從一個 Bean 存取另一個 Bean 所需要的使用者 ID。
- classloader
說明: 定義應用程式類別載入器的設定。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility 字串 spec,ibm-api,api 這個類別載入器將會見到的 API 套件類型,形式為下列項目之任意組合的逗點區隔清單:spec、ibm-api、api、third-party。 classProviderRef 最上層 resourceAdapter 元素的參照清單(以逗點區隔的字串)。 類別提供者參照清單。當搜尋類別或資源時,此類別載入器會在搜尋其本身的類別路徑之後,委派給指定的類別提供者。 commonLibraryRef 最上層 library 元素的參照清單(以逗點區隔的字串)。 程式庫參照的清單。Library 類別實例會與其他類別載入器共用。 delegation - parentFirst
- parentLast
parentFirst 控制在這個類別載入器之前或之後使用母項類別載入器。如果選取「母項優先」,在搜尋類別路徑之前,會先委派給直接母項。如果選取「母項最後」,則會先搜尋類別路徑,再委派給直接母項。 - parentFirst
- 母項優先
- parentLast
- 母項最後
privateLibraryRef 最上層 library 元素的參照清單(以逗點區隔的字串)。 程式庫參照的清單。Library 類別實例是這個類別載入器所專屬,與其他類別載入器的類別實例無關。 - classloader > commonLibrary
說明: 程式庫參照的清單。Library 類別實例會與其他類別載入器共用。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility 字串 spec,ibm-api,api 這個程式庫的類別載入器將會見到的 API 套件類型,形式為下列項目之任意組合的逗點區隔清單:spec、ibm-api、api、third-party。 description 字串 管理者的共用程式庫說明 filesetRef 最上層 fileset 元素的參照清單(以逗點區隔的字串)。 參照之檔案集的 ID id 字串 唯一的配置 ID。 name 字串 管理者的共用程式庫名稱 - classloader > commonLibrary > file
說明: 參照檔的 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id 字串 唯一的配置 ID。 name 檔案的路徑 完整檔名
- classloader > commonLibrary > fileset
說明: 參照之檔案集的 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 caseSensitive 布林 True 用來指出搜尋是否應該區分大小寫的布林(預設值:true)。 dir 目錄的路徑 ${server.config.dir} 要搜尋檔案的基本目錄。 excludes 字串 要從搜尋結果中排除的檔名型樣清單,以逗點或空格區隔,依預設,不排除任何檔案。 id 字串 唯一的配置 ID。 includes 字串 * 要併入搜尋結果的檔名型樣清單,以逗點或空格區隔(預設值:*)。 scanInterval 具有毫秒精準度的時間量 0 檢查檔案集是否變更的掃描間隔,這是一個 long 值,含有時間單位字元 h(時)、m(分)、s(秒)、ms(毫秒),例如:2ms 或 5s。 依預設,會停用 (scanInterval=0)。 請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m)、秒 (s) 或毫秒 (ms)。 例如,500 毫秒指定為 500ms。 單一項目可以包含多個值。比方說,1s500ms 相當於 1.5 秒。
- classloader > privateLibrary
說明: 程式庫參照的清單。Library 類別實例是這個類別載入器所專屬,與其他類別載入器的類別實例無關。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility 字串 spec,ibm-api,api 這個程式庫的類別載入器將會見到的 API 套件類型,形式為下列項目之任意組合的逗點區隔清單:spec、ibm-api、api、third-party。 description 字串 管理者的共用程式庫說明 filesetRef 最上層 fileset 元素的參照清單(以逗點區隔的字串)。 參照之檔案集的 ID id 字串 唯一的配置 ID。 name 字串 管理者的共用程式庫名稱 - classloader > privateLibrary > file
說明: 參照檔的 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id 字串 唯一的配置 ID。 name 檔案的路徑 完整檔名
- classloader > privateLibrary > fileset
說明: 參照之檔案集的 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 caseSensitive 布林 True 用來指出搜尋是否應該區分大小寫的布林(預設值:true)。 dir 目錄的路徑 ${server.config.dir} 要搜尋檔案的基本目錄。 excludes 字串 要從搜尋結果中排除的檔名型樣清單,以逗點或空格區隔,依預設,不排除任何檔案。 id 字串 唯一的配置 ID。 includes 字串 * 要併入搜尋結果的檔名型樣清單,以逗點或空格區隔(預設值:*)。 scanInterval 具有毫秒精準度的時間量 0 檢查檔案集是否變更的掃描間隔,這是一個 long 值,含有時間單位字元 h(時)、m(分)、s(秒)、ms(毫秒),例如:2ms 或 5s。 依預設,會停用 (scanInterval=0)。 請指定一個正整數,後面接著一個時間單位,可以是時 (h)、分 (m)、秒 (s) 或毫秒 (ms)。 例如,500 毫秒指定為 500ms。 單一項目可以包含多個值。比方說,1s500ms 相當於 1.5 秒。
- resourceAdapter
說明: 指定內嵌在應用程式中之資源配接器的配置。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 alias 字串 ${id} 置換資源配接器的預設 ID。此 ID 用於資源配接器之配置內容元素的名稱中,繼而用來決定資源配接器所提供之任何資源的配置內容元素名稱。資源配接器之配置內容元素的名稱格式是 properties.<APP_NAME>.<ALIAS>,其中 <APP_NAME> 是應用程式的名稱,<ALIAS> 是所配置的別名。如果沒有指定,別名的預設值為資源配接器的模組名稱。 autoStart 布林 配置資源配接器會在部署資源配接器之後自動啟動,或延遲到注入或查閱資源之後才啟動。 contextServiceRef 最上層 contextService 元素的參照(字串)。 配置如何擷取環境定義並傳播到執行緒。 id 字串 識別套用這項配置之內嵌資源配接器模組的名稱。 - resourceAdapter > contextService
說明: 配置如何擷取環境定義並傳播到執行緒。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定一個基本環境定義服務,以便從中繼承這個環境定義服務所未定義的環境定義。 jndiName 字串 JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定用來回應配置錯誤的動作。 比方說,如果這個 contextService 配置了 securityContext,但未啟用安全特性,onError 會決定是失敗、發出警告,或忽略配置不正確的部分。 - IGNORE
- 當伺服器發現配置錯誤時,不發出任何警告和錯誤訊息。
- FAIL
- 第一次出現錯誤時,伺服器發出警告或錯誤訊息,然後停止。
- WARN
- 當伺服器發現配置錯誤時,發出警告和錯誤訊息。
- resourceAdapter > contextService > baseContext
說明: 指定一個基本環境定義服務,以便從中繼承這個環境定義服務所未定義的環境定義。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定一個基本環境定義服務,以便從中繼承這個環境定義服務所未定義的環境定義。 id 字串 唯一的配置 ID。 jndiName 字串 JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定用來回應配置錯誤的動作。 比方說,如果這個 contextService 配置了 securityContext,但未啟用安全特性,onError 會決定是失敗、發出警告,或忽略配置不正確的部分。 - IGNORE
- 當伺服器發現配置錯誤時,不發出任何警告和錯誤訊息。
- FAIL
- 第一次出現錯誤時,伺服器發出警告或錯誤訊息,然後停止。
- WARN
- 當伺服器發現配置錯誤時,發出警告和錯誤訊息。
- resourceAdapter > contextService > baseContext > baseContext
說明: 指定一個基本環境定義服務,以便從中繼承這個環境定義服務所未定義的環境定義。必要: false資料類型: com.ibm.ws.context.service-factory
- resourceAdapter > contextService > baseContext > classloaderContext
說明: 類別載入器環境定義傳播配置。必要: false資料類型:
- resourceAdapter > contextService > baseContext > jeeMetadataContext
說明: 將提交環境定義作業之應用程式元件的名稱空間提供給作業。必要: false資料類型:
- resourceAdapter > contextService > baseContext > securityContext
說明: 當指定時,會將工作起始器的安全環境定義傳播到工作單元。必要: false資料類型:
- resourceAdapter > contextService > baseContext > syncToOSThreadContext
說明: 如果指定,工作單元的「runAs 主題」的身分會與「作業系統」身分同步。必要: false資料類型:
- resourceAdapter > contextService > baseContext > zosWLMContext
說明: 指出「z/OS WLM 環境定義」應當成執行緒環境定義的一部分來一起管理。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 daemonTransactionClass 字串 ASYNCDMN 當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 defaultTransactionClass 字串 ASYNCBN 當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 wlm - Propagate
- PropagateOrNew
- 新建
Propagate 指出應如何處理「非常駐程式」工作的 WLM 環境定義。 - Propagate
- 使用相同的 WLM 環境定義(如果有的話)。
- PropagateOrNew
- 使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。
- 新建
- 一律建立新的 WLM 環境定義。
- resourceAdapter > contextService > syncToOSThreadContext
說明: 如果指定,工作單元的「runAs 主題」的身分會與「作業系統」身分同步。必要: false資料類型:
- resourceAdapter > contextService > zosWLMContext
說明: 指出「z/OS WLM 環境定義」應當成執行緒環境定義的一部分來一起管理。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 daemonTransactionClass 字串 ASYNCDMN 當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 defaultTransactionClass 字串 ASYNCBN 當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 wlm - Propagate
- PropagateOrNew
- 新建
Propagate 指出應如何處理「非常駐程式」工作的 WLM 環境定義。 - Propagate
- 使用相同的 WLM 環境定義(如果有的話)。
- PropagateOrNew
- 使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。
- 新建
- 一律建立新的 WLM 環境定義。
- resourceAdapter > customize
說明: 使用指定的介面及/或實作類別,來自訂啟動規格、受管理物件或 Connection Factory 的配置內容元素。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 implementation 字串 應自訂其配置內容元素的實作類別完整名稱。 interface 字串 應自訂其配置內容元素的介面類別完整名稱。 suffix 字串 置換配置內容元素的預設字尾。例如,properties.rarModule1.CustomConnectionFactory 中的 "CustomConnectionFactory"。 當資源配接器提供了多種類型的 Connection Factory、受管理物件或端點啟動時,使用字尾有助於釐清。如果所自訂的配置內容元素省略了字尾或將它留白,就不會使用字尾。
參照主題