Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

14.3. 配置 jca 子系统

jca 子系统控制 Jakarta Connectors 容器和资源适配器部署的一般设置。您可以使用管理控制台或管理 CLI 配置 jca 子系统。

要配置的主要 jca 子系统元素有：

14.3.1. 管理控制台中的 JCA 子系统设置
复制链接

您可以从管理控制台配置 jca 子系统，方法是导航到 Configuration Subsystems JCA 并点 View。然后，选择适当的标签页：

  • 配置

    包含缓存的连接管理器、存档验证和 bean 验证的设置。打开适当的选项卡并单击 Edit 链接，以修改这些设置。

  • Bootstrap 上下文

    包含配置的 bootstrap 上下文列表。可以添加新的 bootstrap 上下文对象，并进行配置。每个 bootstrap 上下文都必须分配一个工作管理器。

  • WorkManager

    包含配置的工作管理器列表。可以在此处添加、删除新的工作管理器及其线程池。每个工作管理器都可以有一个简短运行的线程池和可选的长时间运行的线程池。

可以通过在所选工作管理器上 点击线程池 来配置线程池属性。

14.3.2. 管理 CLI 中的 JCA 子系统设置
复制链接

您可以按照此流程中的步骤，使用管理 CLI 配置 jca 子系统。

流程

  1. 使用管理 CLI 配置 jca 子系统： 
/subsystem=jca
Copy to Clipboard Toggle word wrap

  1. 在受管域中，您必须在命令前加上： 

    /profile=PROFILE_NAME
    Copy to Clipboard Toggle word wrap
注意

以下部分中的表中的属性名称会在管理模型中出现时列出，例如使用管理 CLI 时。请参阅位于 EAP_HOME/docs/schema/wildfly-jca_5_0.xsd 的 schema 定义文件，以查看 XML 中出现的元素，因为管理模型可能不同。

14.3.3. 归档验证
复制链接

这决定了是否在部署单元上执行存档验证。下表描述了您可以为归档验证设置的属性。

Expand
表 14.1. 归档验证属性
属性默认值描述

enabled

true

指定是否启用归档验证。

fail-on-error

true

指定归档验证错误报告是否失败。

fail-on-warn

false

指定归档验证警告报告是否失败。

如果没有指定归档验证，它将被视为存在，并且 enabled 属性默认为 true。

在部署过程中的错误消息示例

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

14.3.4. Bean 验证
复制链接

Bean 验证决定是否执行 bean 验证。有关规格的详情，请查看 Jakarta Bean 验证规格。

Expand
表 14.2. Bean 验证属性
属性默认值描述

enabled

true

指定是否启用了 bean 验证。

如果未指定 bean 验证，它将被视为存在，并且 enabled 属性默认为 true。

14.3.5. 工作管理器
复制链接

工作管理器管理 Jakarta Connectors 子系统中的工作实例。有两种工作管理器：

  • 默认工作管理器

    默认工作管理器及其线程池。

  • 自定义工作管理器

    自定义工作管理器定义及其线程池。

Expand
表 14.3. 工作管理器属性
属性描述

名称

指定工作管理器的名称。

Elytron-enabled

为工作管理器启用 Elytron 安全性。

工作管理器还具有以下子元素：

Expand
表 14.4. 工作管理器子元素
子元素描述

short-running-threads

标准工作实例的线程池.每个工作管理器都有一个简短运行的线程池。

long-running-threads

Jakarta Connectors 1.7 工作实例的线程池，设置 LONG_RUNNING 提示。每个工作管理器都可以有一个可选长时间运行的线程池。

下表描述了您可以为工作管理器线程池设置的属性。

Expand
表 14.5. 线程池属性
属性描述

allow-core-timeout

确定核心线程是否可以超时的布尔值设置。默认值为 false。

core-threads

核心线程池大小。这必须等于或小于最大线程池大小。

handoff-executor

在无法接受某个任务时，将任务委托给 的 executor。如果未指定，则无法接受的任务将被静默丢弃。

keepalive-time

指定池线程在正常工作后应保留的时间。

max-threads

最大线程池大小。

名称

指定线程池的名称。

queue-length

最大队列长度。

thread-factory

对线程工厂的引用。

14.3.6. 分布式工作管理器
复制链接

分布式工作管理器（分布式工作管理器）实例可以在另一个工作管理器实例上重新排期工作。

以下示例管理 CLI 命令配置分布式工作管理器。请注意，您必须使用提供高可用性功能的配置，如 standalone-ha.xml 或 standalone-full-ha.xml 配置文件。

示例：配置分布式工作管理器

batch
/subsystem=jca/distributed-workmanager=myDistWorkMgr:add(name=myDistWorkMgr)
/subsystem=jca/distributed-workmanager=myDistWorkMgr/short-running-threads=myDistWorkMgr:add(queue-length=10,max-threads=10)
/subsystem=jca/bootstrap-context=myCustomContext:add(name=myCustomContext,workmanager=myDistWorkMgr)
run-batch
Copy to Clipboard Toggle word wrap

注意

short-running-threads 元素的名称必须与 distributed-workmanager 元素的名称相同。

下表描述了您可以为分布式工作管理器配置的属性。

Expand
表 14.6. 分布式工作管理器属性
属性描述

Elytron-enabled

为工作管理器启用 Elytron 安全性。

名称

分布式工作管理器的名称。

policy

策略决定何时重新分发工作实例。允许的值是：

  • NEVER - Never 将工作实例分发到另一节点。
  • ALWAYS - Always 将工作实例分发到另一节点。
  • WATERMARK - 根据当前节点可用的可用 worker 线程数量，将工作实例分配给另一个节点。

policy-options

策略的键/值对选项列表。如果您使用 WATERMARK 策略，您可以使用 水位线 策略选项来指定应分发的可用线程数量。例如： 

/subsystem=jca/distributed-workmanager=myDistWorkMgr:write-attribute(name=policy-options,value={watermark=3})
Copy to Clipboard Toggle word wrap

selector

选择器决定网络中的哪些节点重新分发工作实例。允许的值是：

  • FIRST_AVAILABLE - 选择列表中的第一个可用节点。
  • PING_TIME - 选择具有最低 ping 时间的节点。
  • MAX_FREE_THREADS - 选择具有最高可用 worker 线程数的节点。

selector-options

选择器的键/值对选项列表。

分布式工作管理器还具有以下子元素：

Expand
表 14.7. 分布式工作管理器子元素
子元素描述

long-running-threads

设置 LONG_RUNNING 提示的工作实例的线程池。每个分布式工作管理器都可以有长期运行的线程池。

short-running-threads

标准工作实例的线程池。每个分布式工作管理器都必须有一个简短运行的线程池。

14.3.7. Bootstrap 上下文
复制链接

这用于定义自定义 bootstrap 上下文。下表描述了您可以为 bootstrap 上下文设置的属性。

Expand
表 14.8. Bootstrap 上下文属性
属性描述

名称

指定 bootstrap 上下文的名称。

WorkManager

指定用于此上下文的工作管理器的名称。

14.3.8. 缓存连接管理器
复制链接

缓存的连接管理器用于调试连接并支持事务中连接的延迟列表，跟踪应用程序是否被应用程序正确使用并释放。下表描述了您可以为缓存的连接管理器设置的属性。

Expand
表 14.9. 缓存的连接管理器属性
属性默认值描述

debug

false

失败时输出警告，以显式关闭连接。

错误

false

在失败时抛出异常以显式关闭连接。

ignore-unknown-connections

false

指定不会缓存未知连接。

install

false

启用或禁用缓存的连接管理器 valve 和 interceptor。

14.3.9. 使用管理 CLI 部署资源适配器
复制链接

使用管理 CLI 部署资源适配器。

先决条件

  • 访问管理 CLI。

流程

  1. 将资源适配器部署到独立服务器： 

       ----
   deploy /path/to/resource-adapter.rar
   ----
    Copy to Clipboard Toggle word wrap

  2. 将资源适配器部署到受管域中的所有服务器组： 

       ----
   deploy /path/to/resource-adapter.rar --all-server-groups
   ----
    Copy to Clipboard Toggle word wrap

14.3.10. 使用管理控制台部署资源适配器
复制链接

使用管理控制台部署资源适配器。

先决条件

  • 访问管理控制台。

流程

  1. 登录到管理控制台。
  2. 前往 Deployments 选项卡。

  3. 点 Add (+)按钮。

    • 在受管域中，您将首先需要选择 内容存储库。
  4. 选择 Upload Deployment 选项。
  5. 浏览到资源适配器归档并点 Next。
  6. 验证上传，然后单击 完成。
  7. 在受管域中，将部署部署到适当的服务器组并启用部署

14.3.11. 使用部署扫描程序部署资源适配器
复制链接

使用单机服务器中的部署扫描程序部署资源适配器。

先决条件

  • 访问服务器的文件系统。

流程

  • 要手动将资源适配器部署到单机服务器，请将资源适配器存档复制到服务器部署目录中，如 EAP_HOME/standalone/deployments/。这将由部署扫描程序提取和部署。
注意

此选项不适用于受管域。您必须使用管理控制台或管理 CLI 将资源适配器部署到服务器组中。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat