16.3. 配置 JCA 子系统
jca 子系统控制 JCA 容器和资源适配器部署的一般设置。您可以使用管理控制台或管理 CLI 配置 jca 子系统。
要配置的主要 JCA 元素有：
- 从管理控制台配置 JCA 设置
jca子系统可以通过管理控制台配置，方法是导航到 ConfigurationSubsystems JCA。然后，选择适当的标签页： - Common Config - 包含缓存的连接管理器、归档验证和 bean 验证的设置。它们也包含在自己的标签页中。打开相应的选项卡并单击 Edit 按钮来修改这些设置。
- Bootstrap Contexts - 包含配置的 bootstrap 上下文列表。可以添加、删除和配置新的 bootstrap 上下文对象。每个 bootstrap 上下文都必须分配一个工作管理器。
工作管理器 - 包含已配置的工作管理器的列表。可以添加、移除新的工作管理器，以及在此处配置的线程池。每个工作管理器都可以有一个短运行的线程池和一个可选的长时间运行的线程池。
线程池属性可通过单击所选工作管理器上的 View 来配置。
- 从管理 CLI 配置 JCA 设置
-
jca子系统可以从管理 CLI 从/subsystem=jca地址进行配置。在受管域中，您必须在命令前使用/profile=PROFILE_NAME。
归档验证
这决定是否要在部署单元上执行存档验证。下表描述了您可以为归档验证设置的属性。
| 属性 | 默认值 | 描述 |
|---|---|---|
| enabled | true | 指定是否启用了归档验证。 |
| fail-on-error | true | 指定存档验证错误报告是否失败。 |
| fail-on-warn | false | 指定归档验证警告报告是否失败。 |
如果存档没有正确实现 JCA 规格并启用了归档验证，则部署过程中会显示一个错误消息。例如：
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 Validation
此设置决定是否在部署单元上执行 bean 验证(JSR-303)。下表描述了您可以为 bean 验证设置的属性。
| 属性 | 默认值 | 描述 |
|---|---|---|
| enabled | true | 指定是否启用了 bean 验证。 |
如果没有指定 bean 验证，它被视为存在，并且 enabled 属性默认为 true。
工作管理器
工作管理器有两种类型：
- 默认工作管理器
- 默认工作管理器及其线程池。
- 自定义工作管理器
- 自定义工作管理器定义及其线程池。
下表描述了您可以为工作管理器设置的属性。
| 属性 | 描述 |
|---|---|
| name | 指定工作管理器的名称。 |
| short-running-threads | 标准工作实例的线程池。每个工作管理器都有一个短运行的线程池。 |
| long-running-threads |
设置 |
下表描述了您可以为工作管理器线程池设置的属性。
| 属性 | 默认值 | 描述 |
|---|---|---|
| name | default | 指定线程池的名称。 |
| keepalive-time | 10 秒 | 指定在操作后池线程应保留的时间。 |
| allow-core-timeout | false | 确定内核线程是否可能会超时的布尔值设置。默认值为 false。 |
| thread-factory | 对线程工厂的引用。 | |
| max-thread | 50 | 最大线程池大小。 |
| core-threads | 50 | 核心线程池大小。这必须等于或小于最大线程池大小。 |
| queue-length | 50 | 最大队列长度。 |
Bootstrap 上下文
这用于定义自定义 bootstrap 上下文。下表描述了您可以为 bootstrap 上下文设置的属性。
| 属性 | 描述 |
|---|---|
| name | 指定 bootstrap 上下文的名称。 |
| WorkManager | 指定用于此上下文的工作管理器的名称。 |
缓存的连接管理器
这用于调试连接，并支持事务中的连接的延迟，跟踪应用程序是否正确使用并释放它们。下表描述了您可以为缓存的连接管理器设置的属性。
| 属性 | 默认值 | 描述 |
|---|---|---|
| debug | false | 在失败时输出警告以显式关闭连接。 |
| 错误 | false | 在未能显式关闭连接时抛出异常。 |
| ignore-unknown-connections | false | 指定不缓存未知连接。 |
