企業應用程式 (enterpriseApplication)
定義企業應用程式的內容。
屬性名稱 | 資料類型 | 預設值 | 說明 |
---|---|---|---|
autoStart | boolean | true | 指出伺服器是否會自動啟動應用程式。 |
defaultClientModule | string | 企業應用程式的預設用戶端模組。 | |
id | string | 唯一的配置 ID。 | |
location | 檔案、目錄或 URL。 | 應用程式的位置,以伺服器層次應用程式目錄的絕對路徑或相對路徑表示。 | |
name | string | 應用程式的名稱。 | |
suppressUncoveredHttpMethodWarning | boolean | false | 在應用程式部署期間用來暫停未涵蓋的 HTTP 方法警告訊息的選項。 |
type | string | 應用程式保存檔的類型。 |
- application-bnd
說明: 將應用程式中所包含的一般部署資訊連結到特定的資源。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 version string 應用程式連結規格的版本。 - application-bnd > security-role
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name string 安全角色的名稱。 - application-bnd > security-role > group
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 access-id string 群組存取 ID id string 唯一的配置 ID。 name string 佔有安全角色的群組名稱。
- application-bnd > security-role > run-as
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 password 可逆的編碼密碼(字串) 從一個 Bean 存取另一個 Bean 所需的使用者密碼。其值可以用明碼或編碼形式儲存。如果要將密碼編碼,請搭配使用 securityUtility 工具與編碼選項。 userid string 從一個 Bean 存取另一個 Bean 所需的使用者 ID。
- 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 元素的參照清單(逗點區隔的字串)。 程式庫參照的清單。程式庫類別實例是此類別載入器所特有,不依賴其他類別載入器的類別實例。 - 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 管理者的共用程式庫名稱 - classloader > commonLibrary > file
說明: 參照的檔案 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name 檔案的路徑 完整檔名
- 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 秒。
- 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 管理者的共用程式庫名稱 - classloader > privateLibrary > file
說明: 參照的檔案 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name 檔案的路徑 完整檔名
- 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 秒。
- resourceAdapter
說明: 指定內嵌在應用程式中的資源配接器的配置。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 alias string ${id} 置換資源配接器的預設 ID。資源配接器的配置內容元素名稱中會使用 ID,進而用來判定資源配接器提供之任何資源的配置內容元素名稱。資源配接器的配置內容元素名稱的格式是 properties.<APP_NAME>.<ALIAS>,其中 <APP_NAME> 是應用程式名稱,<ALIAS> 是所配置的別名。如果沒有指定,會將別名預設為資源配接器的模組名稱。 autoStart boolean 配置一旦部署資源配接器就自動啟動資源配接器,或是延緩到注入或查閱資源時才啟動。 contextServiceRef 最上層 contextService 元素的參照(字串)。 配置如何擷取環境定義並延伸到執行緒。 id string 識別要套用這項配置之內嵌資源配接器模組的名稱。 - resourceAdapter > contextService
說明: 配置如何擷取環境定義並延伸到執行緒。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- resourceAdapter > contextService > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 id string 唯一的配置 ID。 jndiName string 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
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。
- resourceAdapter > contextService > baseContext > jeeMetadataContext
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。
- resourceAdapter > contextService > baseContext > securityContext
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。
- resourceAdapter > contextService > baseContext > syncToOSThreadContext
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。
- resourceAdapter > contextService > baseContext > zosWLMContext
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 daemonTransactionClass string ASYNCDMN 當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 defaultTransactionClass string ASYNCBN 當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 id string 唯一的配置 ID。 wlm - Propagate
- PropagateOrNew
- New
Propagate 指出應如何處理「非常駐程式」工作的 WLM 環境定義。 - Propagate
- 使用相同的 WLM 環境定義(若有的話)。
- PropagateOrNew
- 使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。
- New
- 一律建立新的 WLM 環境定義。
- resourceAdapter > contextService > classloaderContext
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。
- resourceAdapter > contextService > jeeMetadataContext
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。
- resourceAdapter > contextService > securityContext
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。
- resourceAdapter > contextService > syncToOSThreadContext
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。
- resourceAdapter > contextService > zosWLMContext
說明: 唯一的配置 ID。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 daemonTransactionClass string ASYNCDMN 當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 defaultTransactionClass string ASYNCBN 當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。 id string 唯一的配置 ID。 wlm - Propagate
- PropagateOrNew
- New
Propagate 指出應如何處理「非常駐程式」工作的 WLM 環境定義。 - Propagate
- 使用相同的 WLM 環境定義(若有的話)。
- PropagateOrNew
- 使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。
- New
- 一律建立新的 WLM 環境定義。
- resourceAdapter > customize
說明: 針對使用指定介面及/或實作類別的啟動規格、受管理物件或 Connection Factory,自訂其配置內容元素。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 implementation string 應自訂其配置內容元素的實作類別完整名稱。 interface string 應自訂其配置內容元素的介面類別完整名稱。 suffix string 置換配置內容元素的預設字尾。例如,properties.rarModule1.CustomConnectionFactory 中的 "CustomConnectionFactory"。當資源配接器提供了多種類型的 Connection Factory、受管理物件或端點啟動時,使用字尾有助於釐清。如果在自訂配置內容元素時省略了字尾或將它留白,則不會使用字尾。