24.5. 资源适配器描述符参考

下表描述了资源适配器描述符文件的元素。

表 24.7. 主要元素

元素 描述
bean-validation-groups 指定应该使用的 Bean 检验组
bootstrap-context 指定应该使用的引导上下文的唯一名称。
config-property 指定资源适配器的配置属性。
transaction-support 定义这个资源适配器支持的事务类型。有效的值为：NoTransaction、LocalTransaction、XATransaction。
connection-definitions 指定连接定义
admin-objects 指定管理对象

表 24.8. Bean 检验组元素

元素 描述
bean-validation-group 指定用于检验的 Bean 检验组的全限定类名

表 24.9. 连接定义 / Admin 对象的属性

属性 描述
class-name 指定受管连接工厂或 Admin 对象的全限定类名。
jndi-name 指定 JNDI 名称
enabled 对象是否被激活
use-java-context 指定是否使用 java:/ JNDI 上下文
pool-name 指定对象的池名
use-ccm 启用缓存的连接管理者

表 24.10. 连接定义元素

元素 描述
config-property 指定受管连接工厂的配置属性。
pool 指定池的设置
xa-pool 指定 XA 池的设置
security 指定安全设置
timeout 指定超时设置
validation 指定检验设置
recovery 指定 XA 恢复设置

表 24.11. 池元素

元素 描述
min-pool-size 指定池应该保持的连接的最小数目。在连接的请求主题知晓之前，这些连接不会被创建。默认值是 0。
max-pool-size 指定某个池的连接的最大数目。每个子池里不会创建超过 max-pool-size 个连接。默认值是 20。
prefill 是否预填充连接池。默认值是 false。
use-strict-min 指定是否严格考虑 min-pool-size。默认值为 false。
flush-strategy 指定在发生错误时如何冲刷池。有效值为：FailingConnectionOnly (默认值)、IdleConnections、EntirePool。

表 24.12. XA 池元素

元素 描述
min-pool-size 指定池应该保持的连接的最小数目。在连接的请求主题知晓之前，这些连接不会被创建。默认值是 0。
max-pool-size 指定某个池的连接的最大数目。每个子池里不会创建超过 max-pool-size 个连接。默认值是 20。
prefill 是否预填充连接池。默认值是 false。
use-strict-min 指定是否严格考虑 min-pool-size。默认值为 false。
flush-strategy 指定在发生错误时如何冲刷池。有效值为：FailingConnectionOnly (默认值)、IdleConnections、EntirePool。
is-same-rm-override is-same-rm-override 元素允许您无条件地设置 javax.transaction.xa.XAResource.isSameRM(XAResource) 返回 true 或 false。
interleaving 为 XA 连接工厂启用 interleaving 的元素
no-tx-separate-pools Oracle 不允许既在 JTA 事务内部又在外部使用 XA 连接。变通办法是为不同的上下文创建单独的子池。
pad-xid 是否保护（Pad）XID
wrap-xa-resource 是否将 XAResource 实例包裹在 org.jboss.tm.XAResourceWrapper 实例里

表 24.13. 安全元素

元素 描述
application 指定应用程序提供的参数（如来自 getConnection(user, pw)）是否可用于区分池里的连接。
security-domain 指定用于区分池里连接的主题（来自安全域）。security-domain 的内容是处理验证的 JAAS 安全管理者的名称。这个名称和 JAAS login-config.xml 的 application-policy/name 属性是关联的。
security-domain-and-application 指定用于区分池里连接的应用程序参数（如来自 getConnection(user, pw)）或主题（来自安全域）。security-domain 的内容是处理验证的 JAAS 安全管理者的名称。这个名称和 JAAS login-config.xml 的 application-policy/name 属性是关联的。

表 24.14. 超时元素

元素 描述
blocking-timeout-millis 指定在抛出异常前等待连接时阻塞的最长时间。请注意，这只是等待连接许可时的阻塞，如果创建连接时超时并不会抛出异常。默认值是 30000（30 秒）。
idle-timeout-minutes 指定连接在被关闭前最长的空闲时间。实际的最长时间也取决于 IdleRemover 扫描时间，它是所有池里最小的 idle-timeout-minutes 的二分之一。
allocation-retry 指定在抛出异常前尝试分配连接的次数。默认值为 0。
allocation-retry-wait-millis 指定试图分配连接时重试的间隔（毫秒）。默认值是 5000 （5 秒）。
xa-resource-timeout 传递给 XAResource.setTransactionTimeout() 的参数。默认为 0，表示不调用 setter。其单位为秒。

表 24.15. 检验元素

元素 描述
background-validation 指定这个连接在使用前应该通过后台线程进行检验。
background-validation-minutes background-validation-minutes 元素
use-fast-fail 在第一次尝试时如果连接无效则失败（true）、或者一直尝试直至遍历连接池里所有连接（false）。默认为 false。

表 24.16. Admin 对象的元素

元素 描述
config-property 指定管理对象的配置属性。

表 24.17. 恢复元素

元素 描述
recover-credential 指定应用于恢复的用户名/密码或安全域。
recover-plugin 指定 org.jboss.jca.core.spi.recovery.RecoveryPlugin 类的实现。
定义在 jboss-as-resource-adapters_1_0.xsd 里的部署模式以及用于自动激活的 http://www.ironjacamar.org/doc/schema/ironjacamar_1_0.xsd。
提交 bug 报告