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
    全局类装入
    属性名称 数据类型 缺省值 描述
    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 > classloaderContext
    描述:类装入器上下文传播配置。
    必需:false
    数据类型:
    contextService > baseContext > jeeMetadataContext
    描述:请使提交上下文任务的应用程序组件的名称空间对任务可用。
    必需:false
    数据类型:
    contextService > baseContext > securityContext
    描述:指定时,工作发起方的安全上下文将传播到工作单元。
    必需:false
    数据类型:
    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 > classloaderContext
    描述:类装入器上下文传播配置。
    必需:false
    数据类型:
    contextService > jeeMetadataContext
    描述:请使提交上下文任务的应用程序组件的名称空间对任务可用。
    必需:false
    数据类型:
    contextService > securityContext
    描述:指定时,工作发起方的安全上下文将传播到工作单元。
    必需:false
    数据类型:
    contextService > syncToOSThreadContext
    描述:如果指定此项,那么工作单元的 runAs 主题的身份将与操作系统身份同步。
    必需:false
    数据类型:
    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 > classloaderContext
    描述:类装入器上下文传播配置。
    必需:false
    数据类型:
    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 > classloaderContext
    描述:类装入器上下文传播配置。
    必需:false
    数据类型:
    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 上下文或创建一个新的 WLM 上下文(如果不存在当前上下文)。
    New
    始终创建新的 WLM 上下文。

    用于指示主题类型的图标 参考主题

    信息中心的条款和条件 | 反馈


    时间戳记图标 最近一次更新时间: Wednesday, 2 September 2015
    http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_feature_concurrent-1.0
    文件名:rwlp_feature_concurrent-1.0.html