24.2. 配置 Java 连接器架构(Java Connector Architecture,JCA)子系统

JBoss EAP 6 配置文件里的 JCA 子系统控制 JCA 容器和资源适配器部署的普通设置。
JCA 子系统的关键元素

归档检验
  • 它设置了在部署单元上执行的归档检验。
  • 下表描述了您可以为归档检验设置的属性。

    表 24.1. 归档检验属性

    属性 默认值 描述
    enabled true
    指定是否启用归档检验
    fail-on-error true
    指定部署失败时是否报告归档检验错误。
    fail-on-warn false
    指定部署失败时是否报告归档检验警告。
  • 如果归档没有正确实现 Java EE 连接器架构规格且启用了归档检验,在部署期间会出现描述这个问题的错误信息。例如:
    Severity: ERROR
    Section: 19.4.2 
    Description: A ResourceAdapter must implement a "public int hashCode()" method. 
    Code: com.mycompany.myproject.ResourceAdapterImpl
    
    Severity: ERROR
    Section: 19.4.2
    Description: A ResourceAdapter must implement a "public boolean equals(Object)" method.
    Code: com.mycompany.myproject.ResourceAdapterImpl
    
  • 如果没有指定归档检验,它会被认作已存在且 enabled 默认为 True。
Bean 检验
  • 这个设置确定 Bean 检验(JSR-303)是否在部署单元上执行。
  • 下表描述了您可以为 Bean 检验设置的属性。

    表 24.2. Bean 检验属性

    属性 默认值 描述
    enabled true
    指定是否启用 Bean 检验。
  • 如果没有指定 Bean 检验,它会被认作已存在且 enabled 默认为 True。
Work Manager
  • 有两种 Work Manager:
    默认的 Work Manager
    默认的 Work Manager 及其线程池。
    自定义 Work Manager
    自定义 Work Manager 定义及其线程池。
  • 下表描述了您可以为 Work Manager 设置的属性。

    表 24.3. Work Manager 的属性

    属性 描述
    name
    指定 Work Manager 的名称。对于自定义 Work Manager 这是必需的。
    short-running-threads
    标准 Work 实例的线程池。每个 Work Manager 都有一个短期运行的线程池。
    long-running-threads
    用于设置 LONG_RUNNING 的 JCA 1.6 Work 实例的线程池。每个 Work Manager 都有一个可选的长期期运行的线程池。
  • 下表描述了您可以为 Work Manager 线程池设置的属性。

    表 24.4. 线程池的属性

    属性 描述
    allow-core-timeout
    Boolean 值,确定核心线程是否超时。默认为 False。
    core-threads
    核心线程池的大小。它必须比线程池的最大尺寸要小。
    queue-length
    队列的最大长度。
    max-thread
    线程池的最大尺寸。
    keepalive-time
    指定在开始工作后池线程应该保持的时间。
    thread-factory
    对线程工厂的引用。
Bootstrap contexts
  • 用来定义自定义引导上下文。
  • 下表描述了您可以为引导上下文设置的属性。

    表 24.5. 引导上下文属性

    属性 描述
    name
    指定引导上下文的名称。
    workmanager
    指定用于这个上下文的 Work Manager 的名称。
缓存的连接管理者
  • 用于调试连接和支持事务里的 Lazy 连接建立,跟踪应用程序是否使用或正确释放它们。
  • 下表描述您可以为缓存连接管理者设置的属性。

    表 24.6. 缓存连接管理者的属性

    属性 默认值 描述
    debug false
    显性关闭连接失败时输出警告
    error false
    显性关闭连接失败时抛出异常

过程 24.1. 用管理控制台配置 JCA 子系统

JBoss EAP 6 的 JCA 子系统可以在管理控制台里进行配置。根据服务器运行的方式,JCA 配置选项在管理控制台里所处的位置会有轻微的不同。
  1. 点击屏幕顶部的 Configuration 标签页。展开 Connector 菜单并选择 JCA
  2. 如果服务器运行于域模式,请从左上角的 Profile 下拉菜单里选择合适的配置集。
  3. 用下列三个标签页配置 JCA 子系统。
    1. Common Config

      Common Config 标签页包含每个缓存连接管理者、归档检验和 Bean 检验(JSR-303)的设置。这些设置都包含在自己的标签页里。您可以打开合适的标签页并点击 Edit 按钮,进行所需修改后再 Save 按钮保存。
      JCA 的常见配置

      图 24.1. JCA 的常见配置

    2. Work Managers

      Work Manager 标签页包含配置的 Work Manager 的列表。您可以新建、删除 Work Manager 以及配置线程池。每个 Work Manager 都可以有一个短期运行以及一个长期运行的的线程池。
      Work Managers

      图 24.2. Work Managers

      线程池的属性可以通过点击所选资源适配器的 View 来配置。
      Work Manager 的线程池

      图 24.3. Work Manager 的线程池

    3. Bootstrap Contexts

      Bootstrap Contexts 标签页包含了 Bootstrap Contexts 列表。您可以创建、删除和配置 Bootstrap Context。每个 Bootstrap Context 都必须分配一个 Work Manager。
      Bootstrap Contexts

      图 24.4. Bootstrap Contexts