A.25. 资源适配器属性

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

注意

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

表 A.55. 主要属性

属性描述

Archive

资源适配器存档。

beanvalidationgroups

应使用的 bean 验证组。

bootstrap-context

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

config-properties

自定义定义的配置属性.

module

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

statistics-enabled

是否启用运行时统计数据.

transaction-support

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

wm-elytron-security-domain

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

wm-security

为此资源适配器开启/关闭 wm.security。如果为 false,则所有 wm-security-* 参数都会被忽略,即使默认值也是如此。

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

用户映射列表.

注意

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

表 A.56. admin-objects 属性

属性描述

class-name

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

enabled

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

jndi-name

管理对象的 JNDI 名称。

use-java-context

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

表 A.57. 连接定义属性

属性描述

allocation-retry

表示在引发异常之前,应尝试分配连接的次数。

allocation-retry-wait-millis

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

authentication-context

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

authentication-context-and-application

表示提供的应用程序参数(如 from getConnection(user、pw)或 Subject 都用于区分池中的连接。在使用配置的验证上下文时,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 身份验证-context 将是当前的上下文。如需更多信息 ,请参阅身份验证 上下文。

enabled

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

加入

指定资源适配器是否应该使用 lazy enlist。

enlistment-trace

指定 JBoss EAP/IronJacamar 是否应该记录条目。默认情况下为 false

flush-strategy

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

FailingConnectionOnly
仅删除失败的连接。这是默认的设置。
InvalidIdleConnections
ValidatingManagedConnectionFactory.getInvalidConnections(…​) 方法会移除共享相同凭证并返回到无效的连接和空闲连接。
IdleConnections
共享同一凭据的失败连接和空闲连接将被删除。
安全
共享同一凭据的失败连接和空闲连接将被删除。在返回到池时,共享相同凭据的活动连接将被销毁。
EntirePool
共享相同凭据的连接以及空闲和活动连接失败。不建议在生产环境中使用这个设置。
AllInvalidIdleConnections
ValidatingManagedConnectionFactory.getInvalidConnections(…​) 方法返回为无效的连接和空闲连接失败。
AllIdleConnections
失败的连接和所有空闲连接被删除。
AllGracefully
失败的连接和所有空闲连接被删除。返回到池后,活动连接将被销毁。
AllConnections
连接失败,以及所有空闲和活跃的连接被删除。不建议在生产环境中使用这个设置。

idle-timeout-minutes

连接在关闭前可能会闲置,以分钟为单位。实际的最长时间还取决于 IdleRemover 扫描时间,这是任何池的最小 空闲时间分钟值 的一半。更改此值需要重新启动服务器。

initial-pool-size

池应保留的初始连接数。

interleaving

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

pad-xid

指定是否应该添加 Xid。

pool-fair

指定池使用应公平。

pool-prefill

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

pool-use-strict-min

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

recovery-authentication-context

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

recovery-credential-reference

凭据(来自凭据存储),用于在恢复连接时进行身份验证。

recovery-elytron-enabled

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

restore-password

用于恢复的密码。

recovery-plugin-class-name

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

recovery-plugin-properties

恢复插件的属性。

recovery-security-domain

用于恢复的安全域。

restore-username

用于恢复的用户名。

same-rm-override

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

security-application

表示应用提供的参数(如 from getConnection(用户、pw) 用于区分池中的连接。

security-domain

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

security-domain-and-application

表示提供的应用提供的参数(如 from getConnection(user、pw)或 Subject 都用于区分池中的连接。

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