A.21. 资源适配器属性


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

表 A.39. 主要属性
属性描述

archive

资源适配器存档。

beanvalidationgroups

应使用的 bean 验证组。

bootstrap-context

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

config-properties

自定义定义的配置属性。

module

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

启用统计

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

transaction-support

资源适配器的事务支持级别。

wm-security

为这个资源适配器打开/关闭 wm.security。如果是 false,则忽略所有 wm-security indices 参数,即使默认值也是如此。

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

用户映射列表。

表 A.40. admin-objects 属性
属性描述

class-name

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

enabled

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

jndi-name

管理对象的 JNDI 名称。

use-java-context

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

表 A.41. connection-definitions 属性
属性描述

allocation-retry

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

allocation-retry-wait-millis

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

background-validation

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

background-validation-millis

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

blocking-timeout-wait-millis

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

capacity-decrementer-class

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

capacity-decrementer-properties

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

capacity-incrementer-class

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

capacity-incrementer-properties

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

class-name

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

connectable

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

enabled

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

enlistment

如果资源适配器支持,则应使用 lazy enlistment。

enlistment-trace

指定 JBoss EAP/IronJacamar 是否应该记录 enlistment trace。

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 不像 XA 连接在 JTA 事务内和外部使用。要解决这个问题,您可以为不同的上下文创建单独的子池。

pad-xid

指定是否应添加 Xid。

pool-fair

指定池使用是否应该公平。

pool-prefill

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

pool-use-strict-min

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

recovery-password

用于恢复的密码。

recovery-plugin-class-name

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

recovery-plugin-properties

恢复插件的属性。

recovery-security-domain

用于恢复的安全域。

recovery-username

用于恢复的用户名。

same-rm-override

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

security-application

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

security-domain

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

security-domain-and-application

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

sharable

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

tracking

指定 IronJacamar 是否应该跟踪跨事务界限的连接处理。

use-ccm

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

use-fast-fail

是否在第一次尝试时失败连接分配(为 ),或者一直尝试直到池耗尽所有潜在连接(错误 )。

use-java-context

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

validate-on-match

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

wrap-xa-resource

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

xa-resource-timeout

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

资源适配器模式可在 EAP_HOME/docs/schema/wildfly-resource-adapters_4_0.xsd 中找到。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.