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

表 24.2. Bean 检验属性
属性	默认值	描述
`enabled`	true	指定是否启用 Bean 检验。

有两种 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 配置选项在管理控制台里所处的位置会有轻微的不同。

点击屏幕顶部的 Configuration 标签页。展开 Connector 菜单并选择 JCA。
如果服务器运行于域模式，请从左上角的 Profile 下拉菜单里选择合适的配置集。
用下列三个标签页配置 JCA 子系统。
1. Common Config
  Common Config 标签页包含每个缓存连接管理者、归档检验和 Bean 检验（JSR-303）的设置。这些设置都包含在自己的标签页里。您可以打开合适的标签页并点击 Edit 按钮，进行所需修改后再 Save 按钮保存。
  图 24.1. JCA 的常见配置
2. Work Managers
  Work Manager 标签页包含配置的 Work Manager 的列表。您可以新建、删除 Work Manager 以及配置线程池。每个 Work Manager 都可以有一个短期运行以及一个长期运行的的线程池。
  图 24.2. Work Managers
  线程池的属性可以通过点击所选资源适配器的 View 来配置。
  图 24.3. Work Manager 的线程池
3. Bootstrap Contexts
  Bootstrap Contexts 标签页包含了 Bootstrap Contexts 列表。您可以创建、删除和配置 Bootstrap Context。每个 Bootstrap Context 都必须分配一个 Work Manager。
  图 24.4. Bootstrap Contexts