A.24. 资源适配器属性


下表描述了资源适配器属性。

注意

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

Expand
表 A.44. 主要属性
属性描述

archive

资源适配器归档。

beanvalidationgroups

应使用的 bean 验证组。

bootstrap-context

应该使用的 bootstrap 上下文的唯一名称。

config-properties

自定义定义的配置属性。

module

将从中加载资源适配器的模块。

启用统计

是否启用运行时统计信息。

transaction-support

资源适配器的事务支持级别。有效值为 NoTransactionLocalTransactionXATransaction

wm-elytron-security-domain

定义应使用的 Elytron 安全域的名称。

wm-security

打开这个资源适配器的 wm.security。如果为 false,则所有 wm-security fluentd 参数都会被忽略,即使是默认值。

wm-security-default-groups

应该添加到使用的 Subject 实例的默认组列表。

wm-security-default-principal

应该添加到使用的 Subject 实例的默认主体名称。

wm-security-domain

应该使用的安全域的名称。

wm-security-mapping-groups

组映射列表。

wm-security-mapping-required

定义安全凭据是否需要映射。

wm-security-mapping-users

用户映射列表。

注意

如果您的资源适配器使用 bootstrap-context 以及将 elytron-enabled 设置为 true 的工作管理器,则必须使用 wm-elytron-security-domain 属性而不是安全域规格的 wm-security-domain 属性。

Expand
表 A.45. admin-objects 属性
属性描述

class-name

管理对象的完全限定类名称。

enabled

指定是否应启用管理对象。

JNDI-name

管理对象的 JNDI 名称。

use-java-context

把它设置为 false 会将对象绑定到全局 JNDI。

Expand
表 A.46. connection-definitions 属性
属性描述

allocation-retry

表示在抛出异常前应尝试分配连接的次数。

allocation-retry-wait-millis

在重试分配连接之间等待的时间(以毫秒为单位)。

authentication-context

Elytron 身份验证上下文,用于定义用于区分池中连接的 jakarta.security.auth.Subject

authentication-context-and-application

表示应用程序提供的参数(如 getConnection (user,pw)Subject )用于区分池中的连接。在使用配置的 authentication-context 时,Elytron 在身份验证后提供这些参数。

background-validation

指定连接应在后台线程上进行验证,而不是在使用前进行验证。更改此值需要重启服务器。

background-validation-millis

后台验证将运行的时间(以毫秒为单位)。更改此值需要重启服务器。

blocking-timeout-wait-millis

在抛出异常前等待连接时的最大时间(以毫秒为单位)。请注意,这个块仅在等待锁定连接时抛出异常,如果创建新连接需要很长时间,则永远不会抛出异常。

capacity-decrementer-class

类定义池中减少连接的策略。

capacity-decrementer-properties

在类中注入的属性,以定义池中减少连接的策略。

capacity-incrementer-class

定义在池中递增连接的策略。

capacity-incrementer-properties

在类中注入的属性,定义用于递增池中连接的策略。

class-name

受管连接工厂或 admin 对象的完全限定类名称。

可连接

启用 CMR 使用。这个功能意味着本地资源可以可靠地参与 XA 事务。

Elytron-enabled

启用 Elytron 安全来处理连接身份验证。如果没有指定上下文,要使用的 Elytron authentication-context 将是当前上下文。如需更多信息,请参阅 authentication-context

enabled

指定是否应启用资源适配器。

Enlistment

指定资源适配器支持时使用 lazy enlistment。

enlistment-trace

指定 JBoss EAP/IronJacamar 是否应该记录追踪。默认为 false

flush-strategy

指定在出错时应如何清空池。有效值为:

FailingConnectionOnly
只有失败的连接被删除。这是默认设置。
InvalidIdleConnections
删除共享相同凭证的失败连接和闲置连接,并由 ValidatingManagedConnectionFactory.getInvalidConnections (…​) 方法返回。
IdleConnections
删除共享相同凭证的失败连接和闲置连接。
正常
删除共享相同凭证的失败连接和闲置连接。共享相同凭据的活动连接在返回到池时被销毁。
EntirePool
删除共享相同凭证的失败连接和闲置以及活跃连接。不建议在生产环境中使用此设置。
AllInvalidIdleConnections
通过 ValidatingManagedConnectionFactory.getInvalidConnections (…​) 方法返回的失败连接和闲置连接会被删除。
AllIdleConnections
失败的连接和所有闲置连接都会被删除。
AllGracefully
失败的连接和所有闲置连接都会被删除。当返回到池时,活跃连接会被销毁。
allConnections
失败的连接以及所有闲置和活跃连接都会被删除。不建议在生产环境中使用此设置。

idle-timeout-minutes

在关闭前,连接可能会处于闲置状态的最长时间(以分钟为单位)。实际最长时间还取决于 IdleRemover 扫描时间,即任何池的最小 idle-timeout-minutes 值的一半。更改此值需要重启服务器。

initial-pool-size

池应保留的初始连接数。

交集

指定是否为 XA 连接启用交集。

JNDI-name

连接工厂的 JNDI 名称。

max-pool-size

池连接的最大数量。每个子池中不会创建更多连接。

mcp

ManagedConnectionPool 实现。例如: org.jboss.jca.core.connectionmanager.pool.mcp.SemaphoreArrayListManagedConnectionPool

min-pool-size

池的最小连接数。

no-recovery

指定是否应从恢复中排除连接池。

no-tx-separate-pool

Oracle 不像在 Jakarta 交易交易外被使用的 XA 连接。要解决这个问题,您可以为不同的上下文创建单独的子池。

pad-xid

指定 Xid 是否应该被 padded。

pool-fair

指定池使用是否应公平。

pool-prefill

指定是否应预先填充池。更改此值需要重启服务器。

pool-use-strict-min

指定 min-pool-size 是否应该被视为 strict。

recovery-authentication-context

用于恢复的 Elytron 身份验证上下文。如果没有指定 authentication-context,则使用当前上下文。

recovery-credential-reference

从凭证存储中进行凭证,以便在恢复连接时进行身份验证。

recovery-elytron-enabled

表示将使用 Elytron 身份验证上下文恢复。默认值为 false

recovery-password

用于恢复的密码。

recovery-plugin-class-name

恢复插件实现的完全限定类名称。

recovery-plugin-properties

恢复插件的属性。

recovery-security-domain

用于恢复的安全域。

recovery-username

用于恢复的用户名。

same-rm-override

无条件设置 jakarta.transaction.xa.XAResource.isSameRM (XAResource) 返回 true 或 false。

security-application

表示应用程序提供的参数(如 getConnection (user, pw) )用于区分池中的连接。

security-domain

定义用于区分池中的连接的 jakarta.security.auth.Subject 的安全域。

security-domain-and-application

表示应用程序提供的参数(如 getConnection (user,pw)Subject )与安全域的,用于区分池中的连接。

sharable

启用 sharable 连接,允许启用 lazy 关联(如果支持)。

tracking

指定 IronJacamar 是否应该跟踪跨事务边界的连接句柄。

use-ccm

启用使用缓存的连接管理器。

use-fast-fail

当设置为 true 时,第一次尝试连接分配无效时会失败。当设置为 false 时,请一直尝试,直到池耗尽所有潜在的连接。

use-java-context

把它设置为 false 会将对象绑定到全局 JNDI。

validate-on-match

指定连接工厂试图与受管连接匹配时是否应该进行连接验证。这通常专用于使用后台验证。

wrap-xa-resource

指定 XAResource 实例是否应嵌套在 org.jboss.tm.XAResourceWrapper 实例中。

xa-resource-timeout

该值将传递到 XAResource.setTransactionTimeout (),以秒为单位。默认值为 0

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat