主页
产品
Red Hat JBoss Enterprise Application Platform
6.2
管理和配置指南
21.2. 配置 Java 连接器架构（Java Connector Architecture，JCA）子系统

21.2. 配置 Java 连接器架构（Java Connector Architecture，JCA）子系统

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

JCA 子系统的关键元素

归档检验

它设置了在部署单元上执行的归档检验。

下表描述了您可以为归档检验设置的属性。

Expand

表 21.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

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

Copy to Clipboard

Toggle word wrap

如果没有指定归档检验，它会被认作已存在且 enabled 默认为 True。

Bean 检验

这个设置确定 Bean 检验（JSR-303）是否在部署单元上执行。
下表描述了您可以为 Bean 检验设置的属性。
Expand
表 21.2. Bean 检验属性
属性默认值描述
enabled true
指定是否启用 Bean 检验。
如果没有指定 Bean 检验，它会被认作已存在且 enabled 默认为 True。

Work Manager

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

有两种 Work Manager：
默认的 Work Manager
默认的 Work Manager 及其线程池。
自定义 Work Manager
自定义 Work Manager 定义及其线程池。

下表描述了您可以为 Work Manager 设置的属性。

Expand

表 21.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 线程池设置的属性。

Expand

表 21.4. 线程池的属性
属性	描述
`allow-core-timeout`	Boolean 值，确定核心线程是否超时。默认为 False。
`core-threads`	核心线程池的大小。它必须比线程池的最大尺寸要小。
`queue-length`	队列的最大长度。
`max-thread`	线程池的最大尺寸。
`keepalive-time`	指定在开始工作后池线程应该保持的时间。
`thread-factory`	对线程工厂的引用。

Bootstrap contexts

用来定义自定义引导上下文。

下表描述了您可以为引导上下文设置的属性。

Expand

表 21.5. 引导上下文属性
属性	描述
`name`	指定引导上下文的名称。
`workmanager`	指定用于这个上下文的 Work Manager 的名称。

缓存的连接管理者

用于调试连接和支持事务里的 Lazy 连接建立，跟踪应用程序是否使用或正确释放它们。

下表描述您可以为缓存连接管理者设置的属性。

Expand

表 21.6. 缓存连接管理者的属性
属性	默认值	描述
`debug`	false	显性关闭连接失败时输出警告
`error`	false	显性关闭连接失败时抛出异常

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

JBoss EAP 6 的 JCA 子系统可以在管理控制台里进行配置。根据服务器运行的方式，JCA 配置选项在管理控制台里所处的位置会有轻微的不同。
- 如果服务器作为独立服务器运行，请遵循下列步骤：
  1. 点击右上角的 Profile 链接切换至 Profile 视图。
  2. 确保展开左侧导航面板的 Profile 部分。
  3. 点击 Connector 展开它并点击 JCA。
- 如果服务器是作为受管域的一部分运行，请遵循下列步骤：
  1. 点击右上角的 Profile 链接切换至 Profile 视图。
  2. 从左侧导航面板的顶部的 Profile 菜单里选择您要修改的配置集。
  3. 点击 Connector 展开它并点击 JCA。
用下列三个标签页配置 JCA 子系统。
1. Common Config
  Common Config 标签页包含每个缓存连接管理者、归档检验和 Bean 检验（JSR-303）的设置。这些设置都包含在自己的标签页里。您可以打开合适的标签页并点击 Edit 按钮，进行所需修改后再 Save 按钮保存。
  
  View larger image
  
  图 21.1. JCA 的常见配置
2. Work Managers
  Work Manager 标签页包含配置的 Work Manager 的列表。您可以新建、删除 Work Manager 以及配置线程池。每个 Work Manager 都可以有一个短期运行以及一个长期运行的的线程池。
  
  View larger image
  
  图 21.2. Work Managers
  线程池的属性可以在这里配置：
  
  View larger image
  
  图 21.3. Work Manager 的线程池
3. Bootstrap Contexts
  Bootstrap Contexts 标签页包含了 Bootstrap Contexts 列表。您可以创建、删除和配置 Bootstrap Context。每个 Bootstrap Context 都必须分配一个 Work Manager。
  
  View larger image
  
  图 21.4. Bootstrap Contexts