24.5. 资源适配器描述符参考
下表描述了资源适配器描述符文件的元素。
| 元素 | 描述 |
|---|---|
bean-validation-groups | 指定应该使用的 Bean 检验组 |
bootstrap-context | 指定应该使用的引导上下文的唯一名称。 |
config-property | 指定资源适配器的配置属性。 |
transaction-support | 定义这个资源适配器支持的事务类型。有效的值为：NoTransaction、LocalTransaction、XATransaction。 |
connection-definitions | 指定连接定义 |
admin-objects | 指定管理对象 |
| 元素 | 描述 |
|---|---|
bean-validation-group | 指定用于检验的 Bean 检验组的全限定类名 |
| 属性 | 描述 |
|---|---|
class-name | 指定受管连接工厂或 Admin 对象的全限定类名。 |
jndi-name | 指定 JNDI 名称 |
enabled | 对象是否被激活 |
use-java-context | 指定是否使用 java:/ JNDI 上下文 |
pool-name | 指定对象的池名 |
use-ccm | 启用缓存的连接管理者 |
| 元素 | 描述 |
|---|---|
config-property | 指定受管连接工厂的配置属性。 |
pool | 指定池的设置 |
xa-pool | 指定 XA 池的设置 |
security | 指定安全设置 |
timeout | 指定超时设置 |
validation | 指定检验设置 |
recovery | 指定 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。 |
| 元素 | 描述 |
|---|---|
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 实例里 |
| 元素 | 描述 |
|---|---|
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 属性是关联的。 |
| 元素 | 描述 |
|---|---|
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。其单位为秒。 |
| 元素 | 描述 |
|---|---|
background-validation | 指定这个连接在使用前应该通过后台线程进行检验。 |
background-validation-minutes | background-validation-minutes 元素 |
use-fast-fail | 在第一次尝试时如果连接无效则失败（true）、或者一直尝试直至遍历连接池里所有连接（false）。默认为 false。 |
| 元素 | 描述 |
|---|---|
config-property | 指定管理对象的配置属性。 |
| 元素 | 描述 |
|---|---|
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。
