企業應用程式 (enterpriseApplication)

定義企業應用程式的內容。

屬性名稱 資料類型 預設值 說明
autoStart 布林 True 指出伺服器是否自動啟動應用程式。
defaultClientModule 字串   企業應用程式的預設用戶端模組。
id 字串   唯一的配置 ID。
location 檔案、目錄或 URL。   應用程式的位置,以絕對路徑或相對於伺服器層次應用程式目錄的路徑表示。
name 字串   應用程式的名稱。
suppressUncoveredHttpMethodWarning 布林 false 這個選項會在應用程式部署期間抑制所發現的 HTTP 方法警告訊息。
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。
application-bnd > security-role > special-subject
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id 字串   唯一的配置 ID。
type
  • EVERYONE
  • ALL_AUTHENTICATED_USERS
  下列特殊主體類型之一:ALL_AUTHENTICATED_USERS、EVERYONE。
EVERYONE
每個人
ALL_AUTHENTICATED_USERS
所有已鑑別的使用者
application-bnd > security-role > user
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
access-id 字串   一般格式的使用者存取 ID (user:realmName/userUniqueId)。 如果沒有指定,會產生一個值。
id 字串   唯一的配置 ID。
name 字串   具備安全角色之使用者的名稱。
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 > commonLibrary > folder
說明:參照之資料夾的 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併入檔案庫類別路徑中,以便尋找資源檔的目錄或資料夾
id 字串   唯一的配置 ID。
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 秒。
classloader > privateLibrary > folder
說明:參照之資料夾的 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併入檔案庫類別路徑中,以便尋找資源檔的目錄或資料夾
id 字串   唯一的配置 ID。
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 > classloaderContext
說明:類別載入器環境定義傳播配置。
必要:false
資料類型:
resourceAdapter > contextService > jeeMetadataContext
說明:將提交環境定義作業之應用程式元件的名稱空間提供給作業。
必要:false
資料類型:
resourceAdapter > contextService > securityContext
說明:當指定時,會將工作起始器的安全環境定義傳播到工作單元。
必要:false
資料類型:
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、受管理物件或端點啟動時,使用字尾有助於釐清。如果所自訂的配置內容元素省略了字尾或將它留白,就不會使用字尾。

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



「時間戳記」圖示 前次更新: 2016 年 6 月 3 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rwlp_config_enterpriseApplication
檔名:rwlp_config_enterpriseApplication.html