Concurrency Utilities for Java EE 1.0
此功能部件允许创建受管执行者,这些受管执行者使应用程序能够提交任务以并行运行,线程上下文由应用程序服务器管理。它还允许创建受管线程工厂,以创建通过组件(它查找受管线程工厂)的线程上下文运行的线程。
启用此功能部件
要启用 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 布尔型 false 是将 jar: URL 还是将 wsjar: URL 用于引用归档中的文件 - contextService
- 配置上下文传播至线程的方式
属性名称 数据类型 缺省值 描述 baseContextRef 对顶级 contextService 元素的引用(字符串)。 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。 id 字符串 唯一配置标识。 jndiName string JNDI 名称 onError - IGNORE
- FAIL
- WARN
WARN 确定用于响应配置错误的操作。例如,如果为此 contextService 配置了 securityContext,但未启用安全性功能,那么 onError 会确定是对错误配置部分执行使失效操作、发出警告操作还是忽略操作。 - IGNORE
- 服务器在发生配置错误时将不会发出警告和错误消息。
- FAIL
- 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
- WARN
- 服务器在发生配置错误时将发出警告和错误消息。
- contextService > baseContext
描述: 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。必需: false数据类型: 属性名称 数据类型 缺省值 描述 baseContextRef 对顶级 contextService 元素的引用(字符串)。 指定从其继承上下文的基本上下文服务(尚未在此上下文服务上定义此上下文)。 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 上下文或创建一个新的 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 上下文或创建一个新的 WLM 上下文(如果不存在当前上下文)。
- New
- 始终创建新的 WLM 上下文。
- managedExecutorService
- 受管执行者服务
属性名称 数据类型 缺省值 描述 contextServiceRef 对顶级 contextService 元素的引用(字符串)。 DefaultContextService 配置上下文传播至线程的方式 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 字符串 唯一配置标识。 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 上下文或创建一个新的 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 上下文或创建一个新的 WLM 上下文(如果不存在当前上下文)。
- New
- 始终创建新的 WLM 上下文。
- managedScheduledExecutorService
- 受管已调度执行者服务
属性名称 数据类型 缺省值 描述 contextServiceRef 对顶级 contextService 元素的引用(字符串)。 DefaultContextService 配置上下文传播至线程的方式 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 字符串 唯一配置标识。 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 上下文或创建一个新的 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 上下文或创建一个新的 WLM 上下文(如果不存在当前上下文)。
- New
- 始终创建新的 WLM 上下文。
- managedThreadFactory
- 受管线程工厂
属性名称 数据类型 缺省值 描述 contextServiceRef 对顶级 contextService 元素的引用(字符串)。 DefaultContextService 配置上下文传播至线程的方式 createDaemonThreads 布尔型 false 配置由受管线程工厂创建的线程是否应该为守护程序线程。 defaultPriority int 最小值:1
最大值:10
由受管线程工厂创建的线程的缺省优先级。如果未指定,那么会使用创建线程的优先级。优先级不能超过受管线程工厂的最大优先级,在此情况下,会改为使用最大优先级。 id 字符串 唯一配置标识。 jndiName string JNDI 名称 maxPriority int 最小值:1
最大值:10
由受管线程工厂创建的线程的最大优先级。 - 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 字符串 唯一配置标识。 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 上下文或创建一个新的 WLM 上下文(如果不存在当前上下文)。
- New
- 始终创建新的 WLM 上下文。
- managedThreadFactory > contextService > jeeMetadataContext
描述: 请使提交上下文任务的应用程序组件的名称空间对任务可用。必需: 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 上下文或创建一个新的 WLM 上下文(如果不存在当前上下文)。
- New
- 始终创建新的 WLM 上下文。