Concurrency Utilities for Java EE 1.0
這項特性可讓您建立受管理執行程式,讓應用程式提交作業以便與應用程式伺服器管理的執行緒環境定義同時執行。此外,也可以讓您建立受管理執行緒 Factory,以便建立執行緒,來與會查閱受管理執行緒 Factory 的元件的執行緒環境定義搭配執行。
啟用這項特性
如果要啟用 Concurrency Utilities for Java EE 1.0 特性,請在 server.xml 檔的 featureManager 元素內,新增下列的元素宣告:
<feature>concurrent-1.0</feature>
支援的 Java™ 版本
- JavaSE-1.6
- JavaSE-1.7
- JavaSE-1.8
開發相依於這項特性的特性
如果您要開發的特性相依於 Concurrency Utilities for Java EE 1.0 特性,請將下列項目包含在您新特性的特性資訊清單檔 Subsystem-Content 標頭中:
com.ibm.websphere.appserver.concurrent-1.0; type="osgi.subsystem.feature"
啟用這項特性的特性
這項特性提供的標準 API 套件
- javax.enterprise.concurrent
特性配置元素
您可以在 server.xml 檔中使用下列元素,來配置 Concurrency Utilities for Java EE 1.0 特性:
- classloading
- contextService
- managedExecutorService
- managedScheduledExecutorService
- managedThreadFactory
- classloading
- 廣域類別載入
屬性名稱 資料類型 預設值 說明 useJarUrls boolean false 要使用 jar: 或 wsjar: URL 來參照保存檔中的檔案 - contextService
- 配置如何將環境定義延伸到執行緒
屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 id string 唯一的配置 ID。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- contextService > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 id string 唯一的配置 ID。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- contextService > baseContext > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: com.ibm.ws.context.service-factory
- contextService > baseContext > syncToOSThreadContext
說明: 當指定時,工作單元的 runAs 主題身分會與作業系統身分同步化。必要: false資料類型:
- 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 環境定義。
- 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 環境定義。
- managedExecutorService
- 受管理執行程式服務
屬性名稱 資料類型 預設值 說明 contextServiceRef 最上層 contextService 元素的參照(字串)。 DefaultContextService 配置如何將環境定義延伸到執行緒 id string 唯一的配置 ID。 jndiName string JNDI 名稱 - managedExecutorService > contextService
說明: 配置如何將環境定義延伸到執行緒必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- managedExecutorService > contextService > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 id string 唯一的配置 ID。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- managedExecutorService > contextService > baseContext > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: com.ibm.ws.context.service-factory
- managedExecutorService > contextService > baseContext > classloaderContext
說明: 類別載入器環境定義延伸的配置。必要: false資料類型:
- managedExecutorService > contextService > baseContext > jeeMetadataContext
說明: 將提交環境定義作業之應用程式元件的名稱空間提供給作業。必要: false資料類型:
- managedExecutorService > contextService > baseContext > securityContext
說明: 當指定此項時,會將工作起始器的安全環境定義延伸到工作單元。必要: false資料類型:
- managedExecutorService > contextService > baseContext > syncToOSThreadContext
說明: 當指定時,工作單元的 runAs 主題身分會與作業系統身分同步化。必要: false資料類型:
- managedExecutorService > 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 環境定義。
- managedExecutorService > contextService > jeeMetadataContext
說明: 將提交環境定義作業之應用程式元件的名稱空間提供給作業。必要: false資料類型:
- managedExecutorService > contextService > securityContext
說明: 當指定此項時,會將工作起始器的安全環境定義延伸到工作單元。必要: false資料類型:
- managedExecutorService > contextService > syncToOSThreadContext
說明: 當指定時,工作單元的 runAs 主題身分會與作業系統身分同步化。必要: false資料類型:
- managedExecutorService > 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 環境定義。
- managedScheduledExecutorService
- 受管理排程執行程式服務
屬性名稱 資料類型 預設值 說明 contextServiceRef 最上層 contextService 元素的參照(字串)。 DefaultContextService 配置如何將環境定義延伸到執行緒 id string 唯一的配置 ID。 jndiName string JNDI 名稱 - managedScheduledExecutorService > contextService
說明: 配置如何將環境定義延伸到執行緒必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- managedScheduledExecutorService > contextService > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 id string 唯一的配置 ID。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- managedScheduledExecutorService > contextService > baseContext > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: com.ibm.ws.context.service-factory
- managedScheduledExecutorService > contextService > baseContext > classloaderContext
說明: 類別載入器環境定義延伸的配置。必要: false資料類型:
- managedScheduledExecutorService > contextService > baseContext > jeeMetadataContext
說明: 將提交環境定義作業之應用程式元件的名稱空間提供給作業。必要: false資料類型:
- managedScheduledExecutorService > contextService > baseContext > securityContext
說明: 當指定此項時,會將工作起始器的安全環境定義延伸到工作單元。必要: false資料類型:
- managedScheduledExecutorService > contextService > baseContext > syncToOSThreadContext
說明: 當指定時,工作單元的 runAs 主題身分會與作業系統身分同步化。必要: false資料類型:
- managedScheduledExecutorService > 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 環境定義。
- managedScheduledExecutorService > contextService > classloaderContext
說明: 類別載入器環境定義延伸的配置。必要: false資料類型:
- managedScheduledExecutorService > contextService > jeeMetadataContext
說明: 將提交環境定義作業之應用程式元件的名稱空間提供給作業。必要: false資料類型:
- managedScheduledExecutorService > contextService > securityContext
說明: 當指定此項時,會將工作起始器的安全環境定義延伸到工作單元。必要: false資料類型:
- managedScheduledExecutorService > contextService > syncToOSThreadContext
說明: 當指定時,工作單元的 runAs 主題身分會與作業系統身分同步化。必要: false資料類型:
- managedScheduledExecutorService > 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 環境定義。
- managedThreadFactory
- 受管理執行緒 Factory
屬性名稱 資料類型 預設值 說明 contextServiceRef 最上層 contextService 元素的參照(字串)。 DefaultContextService 配置如何將環境定義延伸到執行緒 createDaemonThreads boolean false 配置受管理執行緒 Factory 所建立的執行緒是否應該是常駐程式執行緒。 defaultPriority int 下限:1
上限:10
受管理執行緒 Factory 所建立之執行緒的預設優先順序。如果沒有指定,會使用正在建立之執行緒的優先順序。優先順序不能超過受管理執行緒 Factory 的優先順序上限,在這種情況下,會改用優先順序上限。 id string 唯一的配置 ID。 jndiName string JNDI 名稱 maxPriority int 下限:1
上限:10
受管理執行緒 Factory 所建立之執行緒的優先順序上限。 - managedThreadFactory > contextService
說明: 配置如何將環境定義延伸到執行緒必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- managedThreadFactory > contextService > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 baseContextRef 最上層 contextService 元素的參照(字串)。 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。 id string 唯一的配置 ID。 jndiName string JNDI 名稱 onError - IGNORE
- FAIL
- WARN
WARN 決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
- managedThreadFactory > contextService > baseContext > baseContext
說明: 指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。必要: false資料類型: com.ibm.ws.context.service-factory
- managedThreadFactory > contextService > baseContext > classloaderContext
說明: 類別載入器環境定義延伸的配置。必要: false資料類型:
- managedThreadFactory > contextService > baseContext > jeeMetadataContext
說明: 將提交環境定義作業之應用程式元件的名稱空間提供給作業。必要: false資料類型:
- managedThreadFactory > contextService > baseContext > securityContext
說明: 當指定此項時,會將工作起始器的安全環境定義延伸到工作單元。必要: false資料類型:
- managedThreadFactory > contextService > baseContext > syncToOSThreadContext
說明: 當指定時,工作單元的 runAs 主題身分會與作業系統身分同步化。必要: false資料類型:
- managedThreadFactory > 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 環境定義。
- managedThreadFactory > contextService > jeeMetadataContext
說明: 將提交環境定義作業之應用程式元件的名稱空間提供給作業。必要: false資料類型:
- managedThreadFactory > contextService > securityContext
說明: 當指定此項時,會將工作起始器的安全環境定義延伸到工作單元。必要: false資料類型:
- managedThreadFactory > contextService > syncToOSThreadContext
說明: 當指定時,工作單元的 runAs 主題身分會與作業系統身分同步化。必要: false資料類型:
- managedThreadFactory > 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 環境定義。