Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

22.5. Référence de description d'adaptateur de ressources

Les tableaux suivants décrivent les éléments de description d'adaptateurs de ressources.

Tableau 22.7. Éléments principaux

Élément Description
bean-validation-groups Indique le groupe de validation du bean qui doit être utilisé
bootstrap-context Indique le nom unique du contexte de bootstrapping qui doit être utilisé
config-property Config-property spécifie les propriétés de configuration de l'adaptateur de ressources.
transaction-support Indique le type de transactions pris en charge par l'adaptateur de ressources. La valeurs valides sont : NoTransaction, LocalTransaction, XATransaction
connection-definitions Indique les définitions de connexion
admin-objects Indique les objets d'administration

Tableau 22.8. Éléments de groupes de validation de beans

Élément Description
bean-validation-group Indique le nom de classe complet d'un groupe de validation de beans devant être utilisé pour la validation.

Tableau 22.9. Définition de connexion / attributs d'objets admin

Attribut Description
class-name Indique le nom de classe complet d'une usine de connexions gérée ou d'un objet admin
jndi-name Indique le nom JNDI
enabled L'objet doit-il être activé ?
use-java-context Indique si on doit utiliser un contexte java:/ JNDI
pool-name Indique le nom de pool de l'objet
use-ccm Active le gestionnaire de connexion mis en cache

Tableau 22.10. Éléments de définition de connexion

Élément Description
config-property Config-property spécifie les propriétés de configuration de l'usine de connexions.
pool Indique les paramètres de pooling
xa-pool Indique les paramètres de pooling XA
security Indique les paramètres de sécurité
timeout Indique les paramètres de timeout
validation Indique les paramètres de validation
recovery Indique les paramètres de recouvrement XA

Tableau 22.11. Éléments de pooling

Élément Description
min-pool-size L'élément min-pool-size indique le nombre minimal de connexions qu'un pool peut contenir. Celles-ci ne sont pas créées tant que l'on ne connaît pas le sujet de la demande de connexion. La valeur par défaut est 0
max-pool-size L'élément max-pool-size indique le nombre maximal de connexions d'un pool. On ne pourra pas créer plus de connexions que ce nombre indiqué pour chaque sub-pool. Cette valeur par défaut est à 20.
prefill Indique si l'on doit essayer de pré-remplir le pool de connexion. La valeur par défaut est false.
use-strict-min Indique si la min-pool-size doit être considérée sérieusement. La valeur par défaut est false.
flush-strategy Indique comment le pool doit être vidé en cas d'erreur. Les valeurs valides sont : FailingConnectionOnly (default), IdleConnections, EntirePool

Tableau 22.12. Éléments de pool XA

Élément Description
min-pool-size L'élément min-pool-size indique le nombre minimal de connexions qu'un pool peut contenir. Celles-ci ne sont pas créées tant que l'on ne connaît pas le sujet de la demande de connexion. Cette valeur par défaut à 0
max-pool-size L'élément max-pool-size indique le nombre maximal de connexions d'un pool. On ne pourra pas créer plus de connexions que ce nombre indiqué pour chaque sub-pool. Cette valeur par défaut est à 20.
prefill Indique si l'on doit essayer de pré-remplir le pool de connexion. La valeur par défaut est false.
use-strict-min Indique si la min-pool-size doit être considérée sérieusement. La valeur par défaut est false.
flush-strategy Indique comment le pool doit être vidé en cas d'erreur. Les valeurs valides sont : FailingConnectionOnly (default), IdleConnections, EntirePool
is-same-rm-override L'élément is-same-rm-override element permet de définir inconditionnellement si javax.transaction.xa.XAResource.isSameRM(XAResource) doit renvoyer true or false
interleaving Élément qui permet ou non l'entrelacement des usines de connexions XA
no-tx-separate-pools Oracle n'aime pas que les connexions XA soient utilisées à la fois à l'intérieur et à l'extérieur d'une connexion JTA. Pour résoudre ce problème, vous pourrez créer des sub-pools pour ces contextes différents.
pad-xid Est-ce que le Xid doit être mis en tampon ?
wrap-xa-resource Est-ce que les instances XAResource doivent être encapsulées dans une instance org.jboss.tm.XAResourceWrapper

Tableau 22.13. Éléments de sécurité

Élément Description
application Indique si les paramètres de sécurité fournis, (comme par exemple, à partir de getConnection(user, pw), sont utilisés pour distinguer les connexions d'un pool.
security-domain Indique si des sujets (de domaine de sécurité) sont utilisés pour distinguer les connexions d'un pool. Le contenu du domaine de sécurité correspond au nom du gestionnaire de sécurité JAAS qui gère l'authentification. Ce nom est en corrélation avec l'attribut application-policy/name du descripteur JAAS login-config.xml.
security-domain-and-application Indique que les paramètres de l'application fournis (par exemple, à partir de getConnection(user, pw)) ou que le sujet (du domaine de la sécurité) soient utilisés pour distinguer les connexions du pool. Le contenu du domaine de sécurité est le nom du gestionnaire de sécurité JAAS qui gère l'authentification. Ce nom est en corrélation avec l'attribut application-policy/name du descripteur JAAS login-config.xml.

Tableau 22.14. Éléments de timeout

Élément Description
blocking-timeout-millis L'élément « blocking-timeout-millis » indique la durée maximale en millisecondes de blocage pendant que vous attendez une connexion, avant de lever une exception. Notez que cela bloque uniquement pendant que vous attendez un permis de connexion, et ne soulèvera pas d'exception si la création d'une nouvelle connexion prend un temps excessivement long. La valeur par défaut est 30000 (30 secondes).
idle-timeout-minutes Les éléments idle-timeout-minutes indiquent la durée maximum, en minutes, avant qu'une connexion inutile puisse être fermée. La durée maximum dépend du temps de balayage de l'idleRemover, qui correspond à la moitié du temps « idle-timeout-minutes » le plus petit de n'importe quel pool.
allocation-retry Cet élément de tentative d'allocation indique le nombre de fois que l'on doit allouer un connexion avant de lancer une exception. La valeur par défaut est 0.
allocation-retry-wait-millis Le temps, en millisecondes, qu'il faut attendre avant de retenter d'allouer une connexion. La valeur par défaut est 5000, soit 5 secondes.
xa-resource-timeout Passé à XAResource.setTransactionTimeout(). La valeur par défaut est 0 sans invoquer le setter. Indiqué en secondes.

Tableau 22.15. Éléments de validation

Élément Description
background-validation Élément pour spécifier que les connexions doivent être validées en arrière-plan plutôt qu'avant utilisation
background-validation-minutes L'élément « background-validation-minutes » indique la durée, en minutes, d'exécution de la validation d'arrière-plan.
use-fast-fail Indique s'il y a échec d'allocation de connexion à la première connexion si invalide (true) ou s'il y a de nouvelles tentatives jusqu'à ce que le pool soit épuisé de tout essai de connexion possible (false). La valeur par défaut est false

Tableau 22.16. Éléments d'objets admin

Élément Description
config-property Spécifie une propriété de configuration d'objet d'administration.

Tableau 22.17. Éléments de recouvrement

Élément Description
recover-credential Indique la paire nom / mot de passe ou le domaine de sécurité qui doit être utilisé pour le recouvrement.
recover-plugin Spécifie l'implémentation de org.jboss.jca.core.spi.recovery.RecoveryPlugin class.
Les schéma de déploiement sont définis dans jboss-as-resource-adapters_1_0.xsd et http://www.ironjacamar.org/doc/schema/ironjacamar_1_0.xsd pour l'activation automatique.