JBoss Enterprise Application Platform 5 Guide de d marrage rapide pour le d veloppement de transactions

Transcription

1 JBoss Enterprise Application Platform 5 Guide de d marrage rapide pour le d veloppement de transactions Guide de démarrage avec JBoss Transaction Service Édition Andrew Dinn Mark Little Jonathan Halliday

2 JBoss Enterprise Application Platform 5 Guide de d marrage rapide pour le d veloppement de transactions Guide de démarrage avec JBoss Transaction Service Édition Andrew Dinn Red Hat adinn@redhat.co m Mark Little Red Hat mlittle@redhat.co m Jo nathan Halliday Red Hat jhallida@redhat.co m Publié par Misty Stanley-Jones Red Hat misty@redhat.co m

3 Note légale Copyright 2010 Red Hat. T his document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. Linux is the registered trademark of Linus Torvalds in the United States and other countries. Java is a registered trademark of Oracle and/or its affiliates. XFS is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL is a registered trademark of MySQL AB in the United States, the European Union and other countries. Node.js is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. T he OpenStack Word Mark and OpenStack Logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community. All other trademarks are the property of their respective owners. Résumé Ce guide est une introduction rapide destinée aux développeurs Java qui souhaitent écrire des applications avec les API de JBoss T ransaction Service.

4 Table des matières Table des matières. Préface Conventions d'écriture Conventions typographiques Conventions pour citations mises en avant Notes et avertissements 5 2. Obtenir de l'aide et faire des commentaires Avez-vous besoin d'aide? Vos commentaires sont importants! 6. Chapitre Démarrer avec..... JTA Structure du package Configuration des propriétés Spécifier la location du magasin d'objets Démarquer les transactions UserT ransaction T ransactionmanager T ransaction Implémentations JT A locales versus distribuées JDBC et T ransactions Options configurables 11. Chapitre Démarrer avec..... JTS...../. OTS Structure du package Configuration des propriétés Démarrer et stopper le ORB et BOA/POA Préciser la location du magasin d'objets Propagation de transactions implicites et Interposition Current Résiliation de transaction Usine de transactions Recovery Manager 17. Chapitre Commencer avec Web..... Services T. ransactions et... XT... S Configurer le composant de services web 18. Historique de... révision

5 2 JBoss Enterprise Application Platform 5 Guide de démarrage rapide pour le développement de transactions

6 Préface Préface 1. Conventions d'écriture Ce manuel utilise plusieurs conventions pour souligner l'importance de certains mots ou expressions, mais aussi en vue d'attirer l'attention sur certains passages d'informations précis. Pour les éditions sur support papier et numérique (PDF), ce manuel utilise des caractères issus de Liberation Fonts. La police de caractères Liberation Fonts est également utilisée pour les éditions HT ML si elle est installée sur votre système. Sinon, des polices de caractères alternatives équivalentes sont utilisées. Notez que Red Hat Enterprise Linux 5 et versions supérieures contiennent la police Liberation Fonts par défaut Conventions typographiques Quatre conventions typographiques sont utilisées pour attirer l'attention sur certains mots et expressions. Ces conventions et les circonstances auxquelles elles s'appliquent sont les suivantes. Caractères gras à espacem ent fixe Utilisé pour surligner certaines entrées du système, y compris les commandes shell, les noms de fichiers et les chemins d'accès. Également utilisé pour surligner les touches et les combinaisons de touches. Par exemple : Pour consulter le contenu du fichier m on_nouvel_ouvrage_littéraire qui se situe dans votre dossier courant, saisissez la commande cat m on_nouvel_ouvrage_littéraire à la demande du terminal et appuyez sur Entrée pour exécuter la commande. L'exemple ci-dessus contient un nom de fichier, une commande shell et une touche, tous présentés sous forme de caractères gras à espacement fixe et tous bien distincts grâce au contexte. Les combinaisons de touches se distinguent des touches individuelles par le signe «plus», qui connecte les différentes parties de la combinaison. Par exemple : Appuyez sur Entrée pour exécuter la commande. Appuyez sur Ctrl+Alt+F2 pour basculer sur un terminal virtuel. Le premier exemple présente une touche particulière sur laquelle appuyer. Le second exemple affiche une combinaison de touches : un ensemble de trois touches sur lesquelles il faut appuyer simultanément. Si le code source est mentionné, les noms de classes, les méthodes, les fonctions, les noms de variables et les valeurs de retour citées dans un paragraphe seront présentées comme ci-dessus, en caractères gras à espacem ent fixe. Par exemple : Les classes de fichiers comprennent le nom de classe filesystem pour les noms de fichier, file pour les fichiers et dir pour les dossiers. Chaque classe correspond à un ensemble de permissions associées. Caractères gras proportionnels Cette convention marque le surlignage des mots ou phrases que l'on rencontre sur un système, comprenant des noms d'application, des boîtes de dialogue textuelles, des boutons étiquettés, des 3

7 JBoss Enterprise Application Platform 5 Guide de démarrage rapide pour le développement de transactions cases à cocher et des boutons d'options mais aussi des intitulés de menus et de sous-menus. Par exemple : Sélectionnez Système Préférences Souris à partir de la barre du menu principal pour lancer les Préférences de la souris. À partir de l'onglet Boutons, cliquez sur la case à cocher Pour gaucher puis cliquez sur Fermer pour faire passer le bouton principal de la souris de la gauche vers la droite (ce qui permet l'utilisation de la souris par la main gauche). Pour insérer un caractère spécial dans un fichier gedit, choisissez Applications Accessoires T able des caractères depuis la barre du menu principal. Ensuite, choisissez Recherche T rouver depuis la barre du menu T able des caractères, saisissez le nom du caractère dans le champ Recherche puis cliquez sur Suivant. Le caractère recherché sera surligné dans la T able des caractères. Double-cliquez sur le caractère surligné pour le placer dans le champ T exte à copier, puis cliquez sur le bouton Copier. Vous pouvez désormais revenir à votre document et choisir Modifier Coller depuis la barre du menu gedit. Le texte ci-dessus contient des noms d'applications, des noms de menus et d'autres éléments s'appliquant à l'ensemble du système, des boutons et textes que l'on trouve dans une interface graphique. Ils sont tous présentés sous la forme gras proportionnel et identifiables en fonction du contexte. Italique gras à espacement fixe ou Italique gras proportionnel Qu'ils soient en caractères gras à espacement fixe ou à caractères gras proportionnels, l'ajout de l'italique indique la présence de texte remplaçable ou variable. Les caractères en italique indiquent la présence de texte que vous ne saisissez pas littéralement ou de texte affiché qui change en fonction des circonstances. Par exemple : Pour se connecter à une machine distante en utilisant ssh, saisissez ssh nom d'utilisateur@ domain.name (nom.domaine) après l'invite de commande de la console. Si la machine distante est exem ple.com et que votre nom d'utilisateur pour cette machine est john, saisissez ssh john@ exam ple.com. La commande m ount -o rem ount système de fichiers monte le système de fichiers nommé. Ainsi, pour monter /home dans le système de fichiers, la commande est mount -o rem ount /hom e. Pour connaître la version d'un paquet actuellement installé, utilisez la commande rpm -q paquet. Elle vous permettra de retourner le résultat suivant : version-de-paquet. Remarquez que les mots en gras italique ci-dessus username (nom d'utilisateur), domain.name (nom.domaine), file-system (système de fichiers), package (paquetage), version et release (sortie commerciale). Chaque mot est un espace réservé au texte, soit pour le texte que vous entrez lors de la saisie d'une commande, soit pour le texte affiché par le système. Mis à part l'utilisation habituelle de présentation du titre d'un ouvrage, les caractères italiques indiquent l'utilisation initiale d'un terme nouveau et important. Ainsi : Publican est un système de publication DocBook Conventions pour citations mises en avant Les sorties de terminaux et les citations de code source sont mis en avant par rapport au texte avoisinant. 4

8 Préface avoisinant. Les sorties envoyées vers un terminal sont en caractères Rom ains à espacem ent fixe et présentées ainsi : books Desktop documentation drafts mss photos stuff svn books_tests Desktop1 downloads images notes scripts svgs Les citations de code source sont également présentées en rom ains à espacem ent fixe mais sont présentés et surlignés comme suit : package org.jboss.book.jca.ex1; import javax.naming.initialcontext; public class ExClient { public static void main(string args[]) throws Exception { InitialContext inictx = new InitialContext(); Object ref = inictx.lookup("echobean"); EchoHome home = (EchoHome) ref; Echo echo = home.create(); System.out.println("Created Echo"); } } System.out.println("Echo.echo('Hello') = " + echo.echo("hello")); 1.3. Notes et avertissements Enfin, nous utilisons trois styles visuels pour attirer l'attention sur des informations qui auraient pu être normalement négligées : Note Une remarque est une forme de conseil, un raccourci ou une approche alternative par rapport à une tâche à entreprendre. L'ignorer ne devrait pas provoquer de conséquences négatives, mais vous pourriez passer à côté d'une astuce qui vous aurait simplifiée la vie. Important Les blocs d'informations importantes détaillent des éléments qui pourraient être facilement négligés : des modifications de configurations qui s'appliquent uniquement à la session actuelle ou des services qui ont besoin d'être redémarrés avant toute mise à jour. Si vous ignorez une case étiquetée «Important», vous ne perdrez aucunes données mais cela pourrait être source de frustration et d'irritation. 5

9 JBoss Enterprise Application Platform 5 Guide de démarrage rapide pour le développement de transactions Avertissement Un avertissement ne devrait pas être ignoré. Ignorer des avertissements risque fortement d'entrainer des pertes de données. 2. Obtenir de l'aide et faire des commentaires 2.1. Avez-vous besoin d'aide? Si vous rencontrez des difficultés avec l'une des procédures décrites dans cette documentation, veuillez visiter le Portail Client Red Hat sur Sur le portail client, vous pourrez : effectuer des recherches ou naviguer sur la base de connaissances d'articles de support techniques concernant les produits Red Hat. soumettre une requête de support au service Red Hat Global Support Services (GSS). accéder aux documents des autres produits de Red Hat. Red Hat est l'hôte de nombreuses listes de diffusion traitant de ses logiciels et technologies. Vous trouverez un ensemble des listes de diffusion disponibles au public sur Cliquez sur le nom d'une liste pour vous inscrire à celle-ci ou pour accéder à ses archives Vos commentaires sont importants! Si vous repérez une erreur de typographie dans ce guide, ou si vous pensez à un moyen de parfaire ce guide, faîtes-nous en part! Soumettez-nous un rapport dans Bugzilla sous le produit JBoss Enterprise Application Platform 5 et sous le composant doc- T ransactions_dev_quick_start_guide. Le lien suivant vous conduira vers un format de rapport tout préparé pour le produit dont il s'agit : Remplissez le formulaire suivant dans Bugzilla sous le champ Description. Veillez à être aussi précis que possible quand vous décrivez le problème; cela nous permettra de régler le problème plus rapidement. URL du Document : Numéro et Nom de Section : Description du problème : Suggestions pour améliorer : Informations supplémentaires : N'oubliez pas de mentionner votre nom de façon à ce que nous puissions vous donner tout le crédit que vous méritez à soulever le problème en question. 6

10 Préface 7

11 JBoss Enterprise Application Platform 5 Guide de démarrage rapide pour le développement de transactions Chapitre 1. Démarrer avec JTA Ce chapitre récapitule les fonctions principales requises pour construire une application Java Transactions API (JTA). Si vous n'êtes pas familiarisé avec JT A, commencer par lire la première section du Guide de Dévelopement des Transactions, fourni avec la suite de documentation d'enterprise Application Platform Structure du package Tout ce dont vous avez besoin pour écrire les application JTA de base est inclus dans Enterprise Application Platform. Les packages clé sont détaillés dans Packages liés au JT A. Packages liés au JTA com.arjuna.ats.jts Inclut l'implémentation de JBoss T ransaction Service des APIs (Application Programming Interfaces) de JTS et JTA. com.arjuna.ats.jta Contient le support d'implémentation JT A distant ou local. com.arjuna.ats.jdbc Contient le support JDBC 2.0 transactionnel Configuration des propriétés Vous pouvez configurer JBossJT A en paramétrant divers attributs de propriété, soit en cours d'exécution sur la ligne de commande, ou bien à travers un fichier de propriétés. Le fichier de propriétés initial se situe à $JBOSS_HOME/server/default/conf/jbossts-properties.xm l Spécifier la location du magasin d'objets JBossJT A utilise un magasin d'objets pour enregistrer les résultats de transactions de manière persistante, pour qu'ils puissent être utilisés en cas d'échecs. Pour personnaliser la location du magasin d'objets, vous aurez besoin de passer la location quand vous exécutez l'application, comme illustré dans Exemple 1.1, «Spécifier le Magasin d'objets». Exemple 1.1. Spécifier le Magasin d'objets java Dcom.arjuna.ats.arjuna.objectstore.objectStoreDir=/location/of/objectstore myprogram Par défaut, le magasin de l'objet est situé dans un répertoire qui se trouve sous le répertoire d'exécution en cours. Par défaut, tous les états d'objets sont stockés dans le sous-répertoire defaultstore de la racine du magasin d'objets. Vous pouvez changer le sous-répertoire en configurant la variable de propriété com.arjuna.ats.arjuna.objectstore.localosroot. 8

12 Chapitre 1. Démarrer avec JTA 1.3. Démarquer les transactions L'API JBossJT A est constitué de trois éléments : Une interface de démarcation des transactions d'applications de haut niveau Une interface de gestion des transactions de haut niveau destinées au serveur d'applications et un mappage Java standard du protocole XA X/Open destiné au gestionnaire de ressources transactionnelles Toutes les classes et les interfaces JTA se situent dans le package javax.transaction, et les implémentations JBossJT A correspondantes dans le package com.arjuna.ats.jta UserTransaction L'interface UserT ransaction permet aux applications de surveiller les limites des transactions. Vous pouvez obtenir des implémentations de UserT ransaction via JNDI. Exemple 1.2. Contrôle des transactions // Initialize the context and get UserTransaction InitialContext ic = new InitialContext(); UserTransaction utx = ic.lookup("java:comp/usertransaction") // start transaction work.. utx.begin();.. do work utx.commit(); TransactionManager L'interface T ransactionmanager permet au serveur d'applications de surveiller les limites des transactions pour l'application en cours. Vous pourrez obtenir des implémentations du T ransactionmanager via JNDI. // Initialize the context and get the TransactionManager InitialContext ic = new InitialContext(); TransactinoManager utm = ic.lookup("java:/transactionmanager") Transaction L'interface T ransaction permet aux transactions d'avoir lieu sur la transaction associée à l'objet cible. Chaque transaction de haut niveau est associée à un objet de T ransaction quand la transaction est créée. L'objet T ransaction a plusieurs utilisations possibles, comme l'explique Utilisations possibles de l'interface T ransaction. Utilisations possibles de l'interface T ransaction Inscrit les ressources transactionnelles utilisées par l'application. Inscrivez-vous pour les rappels de synchronisation de transaction. Valider ou annuler la transaction. Obtenez le statut de la transaction. 9

13 JBoss Enterprise Application Platform 5 Guide de démarrage rapide pour le développement de transactions Vous pouvez obtenir un objet T ransaction en invoquant la méthode gett ransaction de l'interface T ransactionmanager, comme le montre Exemple 1.3, «Obtenir une transaction». Exemple 1.3. Obtenir une transaction Transaction txobj = TransactionManager.getTransaction(); 1.4. Implémentations JTA locales versus distribuées Vous devrez vous rapporter aux spécifications JT S/OT S pour la propagation de transactions dans les gestionnaires de transactions afin d'assurer l'interopérabilité entre les applications JT A. Procédure 1.1. Sélection de l'implémentation JT A locale 1. Définir la propriété om.arjuna.ats.jta.jtatmimplementation à com.arjuna.ats.internal.jta.transaction.arjunacore.t ransactionmanagerim ple. 2. Définir com.arjuna.ats.jta.jtautimplementation à com.arjuna.ats.internal.jta.transaction.arjunacore.usert ransactionim ple. Procédure 1.2. Sélectionner l'implémentation JT A distribuée 1. Définir la propriété com.arjuna.ats.jta.jtatmimplementation à com.arjuna.ats.internal.jta.transaction.jts.t ransactionmanagerim ple. 2. Définir la propriété com.arjuna.ats.jta.jtautimplementation à com.arjuna.ats.internal.jta.transaction.jts.usert ransactionim ple JDBC et Transactions JBossJT A supporte la construction d'applications transactionnelles distribuées et locales à la fois, qui accèdent à la base de données par les API JDBC 2.0. JDBC 2.0 supporte two-phase commit (validation des transactions en deux temps), et ressemble au standard XA X/Open. Le support JDBC 2.0 se trouve dans le package com.arjuna.ats.jdbc. JBossJT A intègre des connexions JDBC dans les transactions en fournissant des pilotes JDBC transactionnels par lesquels toutes les interactions ont lieu. Ces pilotes interceptent toutes les invocations et s'assurer qu'elles sont enregistrées avec et conduites par les opérations qui conviennent. Il y a un seul type de pilote transactionnel par l'intermédiaire duquel un conducteur JDBC conducteur peut être piloté. Ce pilote est com.arjuna.ats.jdbc.transactionaldriver, et il implémente l'interface java.sql.driver. Vous pouvez établir la connexion par la méthode java.sql.drivermanager.getconnection. Après avoir établie la connexion, JBossJT A surveille toutes les opérations. Vous pouvez utiliser ces connexions de la même façon que n'importe quelle autre connexion de pilote JDBC. Les connexions de JBossJT A peuvent être utilisées dans plusieurs transactions à la fois. Des threads différents, avec différentes notions de la transaction en cours, peuvent utiliser la même connexion JDBC. JBossJT A effectue la connexion en commun pour chaque transaction au sein de la connexion JDBC. Bien que plusieurs threads peuvent utiliser la même instance de la connexion JDBC, en interne, une instance de connexion différente peut être utilisée pour chaque transaction. À l'exception de la méthode 10

14 Chapitre 1. Démarrer avec JTA close, toutes les opérations sur la connexion au niveau application sont effectuées uniquement sur cette connexion de transaction spécifique. JBossJT A enregistre automatiquement la connexion du pilote JDBC avec la transaction via une ressource appropriée. À la fin de la transaction, cette ressource s'engage ou annule toutes les modifications apportées à la base de données sous-jacente, via des appels appropriés sur le pilote JDBC Options configurables Options configurables importantes montre les fonctionnalités de configuration les plus importantes, avec les valeurs par défaut ou autres valeurs possibles. Pour plus d'informations à ce sujet, veuillez consulter Transactions Development Guide. Options configurables importantes com.arjuna.ats.jta.supportsubtransactions Valeurs possibles 1. Oui (par défaut) 2. Non com.arjuna.ats.jta.jtat MImplementation Valeurs possibles 1. com.arjuna.ats.internal.jta.transaction.arjunacore.t ransactionmanagerimple 2. com.arjuna.ats.internal.jta.transaction.jts.t ransactionmanagerimple com.arjuna.ats.jta.jtaut Implementation Valeurs possibles 1. com.arjuna.ats.internal.jta.transaction.arjunacore.usert ransactionimple 2. com.arjuna.ats.internal.jta.transaction.jts.usert ransactionimple com.arjuna.ats.jta.xabackoffperiod Valeurs possibles 1. Heures en secondes com.arjuna.ats.jdbc.isolationlevel Valeurs possibles 1. N'importe quel niveau d'isolation JDBC supporté 11

15 JBoss Enterprise Application Platform 5 Guide de démarrage rapide pour le développement de transactions Chapitre 2. Démarrer avec JTS / OTS Ce chapitre explique les fonctionnalités clé nécessaires pour construire une application OTS (Object Transaction Service) de base par les interfaces OT S brutes, définies par la spécificaiton Object Management Group (OMG). Ce travail est axé sur les détails d'implémentation. Voir le guide Transactions Development Guide pour un aperçu conceptuel Structure du package T ableau 2.1. Packages importants pour créer les applications OT S Package com.arjuna.orbportability org.omg.cost ransactions com.arjuna.ats.jts com.arjuna.ats.arjuna com.arjuna.ats.jta Description ce package contient les classes qui constituent la bibliothèque de portabilité ORB et les autres classes d'utilitaires utiles. ce package contient les classes qui constitueront le module CosT ransactions.idl. ce package contient les implémentations de JBoss Transaction Service du JTS ou JTA. ce package contient des classes supplémentaires utiles à l'implémentation JBoss Transaction Service du JTS. ce package contient le support d'implémentation JTA distant ou local. com.arjuna.ats.jdbc ce package contient le support JDBC 2.0 transactionnel Configuration des propriétés Vous pouvez configurer JBoss T ransaction Services en cours d'exécution, en paramétrant divers attributs de propriétés, qui sont décrits dans les sections suivantes. Vous pouvez fournir ces attributs en cours d'exécution sur la ligne de commande. Cependant, il est souvent plus pratique de les spécifier à travers un fichier de propriétés jbossts-properties.xm l, qui peut se trouver dans n'importe quelle location spécifiée, dans Locations possibles du fichier jbossts-properties.xm l, dans l'ordre de recherche. Locations possibles du fichier jbossts-properties.xm l 1. Le répertoire de travail en cours. 2. Le répertoire d'accueil d'un utilisateur en cours. 3. Le CLASSPAT H, par la méthode getresource. Quand le fichier de propriétés a été identifié, toutes les entrées qui s'y trouvent sont ajoutées aux propriétés du système, et remplacent les valeurs par défaut. Vous pouvez spécifier d'autres propriétés qui ne sont pas spécifiques au Service de transactions Démarrer et stopper le ORB et BOA/POA BOA se réfère au Basic Object Adapter, et POA se réfère au Portable Object Adapter. 12

16 Chapitre 2. Démarrer avec JTS / OTS JBoss T ransaction Service doit être correctement initialisé avant la création d'un objet d'application. Pour garantir cela, vous devez utiliser la méthode initorb, et une des deux méthodes, soit initboa soit initpoa appartenant à la classe ORBInterface, décrite dans le manuel de portabilité ORB. N'utilisez pas les méthodes ORB_init, BOA_init, ou create_poa fournies par l'orb sous-jacent, car elles pourraient mener à des applications qui n'opèrent pas correctement. Exemple 2.1. Initialisation ORB public static void main (String[] args) { ORBInterface.initORB(args, null); ORBInterface.initOA();... }; ORBInterface Methods orb Renvoie des références à l'orb boa Renvoie des références au BOA poa Renvoie des références au POA rootpoa Renvoie des références à la racine de POA shutdownoa Fermer le BOA. Exécuter ceci avant le shutdownorb, et avant de terminer l'application. shutdownorb Fermer l'orb. Utiliser ceci après le shutdownoa. Exécuter ceci avant de terminer l'application. Utiliser les méthodes shutdownoa et shutdownorb, séquentiellement, avant de fermer l'application. Cela permet à JBoss Transaction Service de procéder aux routines de nettoyage habituelles. La routine shutdownoa ferme le BOA ou le POA, suivant l'orb utilisé. 13

17 JBoss Enterprise Application Platform 5 Guide de démarrage rapide pour le développement de transactions Exemple 2.2. Fermeture de l'orb public static void main (String[] args) {... ORBInterface.shutdownOA(); ORBInterface.shutdownORB(); }; N'utilisez pas davantage d'objets CORBA après le shutdown. Vous aurez besoin de réinitialiser le BOA/POA avant d'utiliser davantage d'objets CORBA. Note L'expression Object Adapter sera utilisée tout au long de ce guide pour faire référence au BOA ou au POA, l'un ou l'autre. Si possible, ce guide utilise les classes de Portabilité d'orb pour masquer les différences entre POA et BOA Préciser la location du magasin d'objets. JBoss T ransaction Services utilise un magasin d'objets pour enregistrer de façon persistante tous les résultats des transactions, pour les recouvrements suite à des défaillances. Vous pouvez spécifier la location du magasin d'objets par la propriété objectstoredir. Exemple 2.3. Spécifier le Magasin d'objets dans l'exécution de l'application. java Dcom.arjuna.ats.arjuna.objectstore.objectStoreDir=/var/tmp/ObjectStore myprogram Par défaut, le magasin d'objets de situe dans un répertoire qui se situe sous le répertoire d'exécution en cours. Dans la configuration par défaut, tous les états d'objets sont stockés dans le defaultstore. Cependant, ce sous-répertoire peut être modifié en définissant la variable de propriété com.arjuna.ats.arjuna.objectstore.localosroot Propagation de transactions implicites et Interposition Vous pouvez créer des transaction dans un domaine et les utiliser dans un autre. De ce fait, l'information sur une transaction, appelée transaction context, a besoin d'être propagée entre ces domaines. Propagation du contexte de transaction Propagation explicite Une application passe des objets de contexte sous forme de paramètres explicites. Ces objets sont soit des instances de l'interface de Control, ou la structure de PropagationContext, et ils sont définis par le Service de propagation. Il est plus efficace d'utiliser la structure PropagationContext à la place de Control 14

18 Chapitre 2. Démarrer avec JTS / OTS Propagation implicite Les demandes sur les objets sont implicitement associées à la transaction du client et partagent le contexte de la transaction du client. Le contexte est implicitement transmis aux objets, sans intervention directe du client. Les objets OT S qui supportent l'interface de Control sont des objets standard CORBA. Quand l'interface est passée comme paramètre dans un appel d'opération vers un serveur distant, seule la référence à l'objet est passée. T out opération effectuée par l'objet distant sur l'interface aura lieu sur l'objet réel. Ce comportement peut imposer des sanctions importantes sur une application qui utilise fréquemment ces interfaces en raison des problèmes de surcharge des invocations distantes. Pour éviter cette surcharge, JBoss T ransaction Service prend en charge l' interposition. En interposition, le serveur crée un objet local qui agit comme un proxy pour la transaction distante, et remplit toutes les demandes qui seraient normalement transmises à l'appelant. Cet objet local s'enregistre avec le coordonnateur de la transaction originale, afin qu'il puisse participer correctement à la fin de la transaction. Les coordonnateurs interposés forment efficacement une structure arborescente avec les coordonnateurs parents, comme le montre Figure 2.1, «Interposition». Figure 2.1. Interposition Note La propagation de transaction implicite n'implique pas qu'une interposition est également utilisée dans le serveur. Plutôt, l'interposition exige normalement une propagation implicite. Si vous avez besoin d'une propagation de contexte implicite et une interposition, veillez à ce que JBoss T ransaction Service soit correctement initialisé avant de créer un objet. Le client et le serveur ont besoin de se mettre d'accord pour savoir si la propagation ou l'interposition, ou aucune d'entre elles, est utilisée. La propagation de contexte implicite n'est possible que sur les ORB qui supportent les filtres et les intercepteurs, ou qui supportent l'interface CosT SPortability. JacORB et JDK miniorb procurent tous deux le support nécessaire. Activer la propagation Propagation de contexte implicite Définir la variable de propriété com.arjuna.ats.jts.contextpropmode à CONT EXT. Interposition 15

19 JBoss Enterprise Application Platform 5 Guide de démarrage rapide pour le développement de transactions Définir la variable de propriété com.arjuna.ats.jts.contextpropmode à INT ERPOSIT ION. Note Pour utiliser l'api avancé de JBoss T ransaction Service, vous devez utiliser l'interposition Current Vous pourrez obtenir le pseudo-objet Current de la classe com.arjuna.ats.jts.ot SManager par sa méthode get_current Résiliation de transaction La durée pendant laquelle un Control peut accéder à une transaction résiliée est spécifique à l'implémentation. Dans JBoss T ransaction Service, si vous utilisez le pseudo-objet Current, toutes les informations sur une transaction sont détruite à la fin. Pour cette raison, vous ne devez pas utiliser de référence de Control de la transaction suite à la validation ou la restauration de la transaction. T outefois, si vous résiliez explicitement la transaction, en utilisant l'interface T erm inator les informations sur la transaction seront supprimées que lorsque toutes les références restantes à son sujet auront été détruites. Vous pourrez signal que les informations sur la transaction ne sont plus nécessaires, à l'aide de la méthode destroycontrol de la classe de l'ots, qui se trouve dans le package com.arjuna.costransactions. Une fois que le programme indique que les informations de transaction ne sont plus nécessaires, vous ne devrez plus utiliser de références de Control de la transaction Usine de transactions Par défaut, JBoss T ransaction Service n'utilise pas de gestionnaire de transactions séparé quand il crée des transactions à travers l'interface Current. Chaque client de transaction possède son propre gestionnaire de transactions T ransactionfactory, qui est co-chargé. Afin de pouvoir remplacer de comportement en cours d'exécution, définir la variable de propriété com.arjuna.ats.jts.transactionmanager à YES. Pour exécuter l'usine de transactions, exécuter le script start-transaction-service, qui se trouve dans le répertoire ATS_ROOT/bin. Current réussit normalement à localiser l'usine CosServices.cfg qui se trouve dans le répertoire $JBOSS_HOME/etc. Ce fichier ressemble au fichier resolve_initial_references, et est automatiquement créé ou mis à jour au démarrage de l'usine de transactions sur une machine précise. Ce fichier doit être copié localement sur chaque machine ayant besoin de partager la même usine de transactions. 16

20 Chapitre 2. Démarrer avec JTS / OTS Note L'information sur CosServices.cfg fait réfèrence au nom et à la location par défaut du fichier de configuration. Pour changer le nom du fichier, utiliser la variable com.arjuna.orbportability.initialreferencesfile. Pour en changer la location, définir la variable com.arjuna.orbportability.initialreferencesroot. Exemple 2.4. Personnalisation du fichier de références initiales. java Dcom.arjuna.orbportability.initialReferencesFile=ref Dcom.arjuna.orbportability.initialReferencesRoot=c:\\temp prog Vous pouvez remplacer le mécanisme de location par défaut en définissant la variable de propriété com.arjuna.orbportability.resolveservice par n'importe quel paramètre listé dans Paramètres ResolveService. Paramètres ResolveService CONFIGURAT ION_FILE Le système utilise le fichier CosServices.cfg. Il s'agit du comportement par défaut. NAME_SERVICE JBoss T ransaction Services tente d'utiliser un service de noms pour localiser l'usine de transactions. Si non supporté, une exception est lancée. BIND_CONNECT JBoss T ransaction Services utilise les mécanismes de liaison spécifiques-orb. Si non suporté, une exception sera lancée. Si com.arjuna.orbportability.resolveservice est spécifié quand l'usine de transactions est en cours d'exécution, l'usine va s'enregistrer elle-même par le mécanisme de résolution spécifié Recovery Manager Vous avez besoin du sous-système de gestionnaire de recouvrement pour veiller à ce que toutes les transactions soient recouvrables en cas de défaillance. Pour démarrer le gestionnaire de recouvrement, exécuter le script start-recovery-m anager dans $ATS_ROOT/bin. 17

21 JBoss Enterprise Application Platform 5 Guide de démarrage rapide pour le développement de transactions Chapitre 3. Commencer avec Web Services Transactions et XTS 3.1. Configurer le composant de services web pour davantage d'informations sur JBoss Transactions XTS, voir la section XTS du guide Guide de Développement de Transactions, qui est fourni avec la suite de documentation d'enterprise Application Platform. 18

22 Chapitre 3. Commencer avec Web Services Transactions et XTS T ableau 3.1. Configuration des services Web Propriété com.arjuna.orbportability.initialreferencesfile com.arjuna.orbportability.initialreferencesroot ArjunaJT S_LicenceKey com.arjuna.orbportability.resolveservice Valeurs possibles CosServices.cfg Le répertoire contient le fichier arjuna.properties. Licence spécifique au système. CONFIGURAT ION_FILE NAME_SERVICE BIND_CONNECT com.arjuna.ats.arjuna.objectstore.objectstoredir com.arjuna.ats.arjuna.objectstore.localosroot PROPERT IES_FILE com.arjuna.ats.arjuna.coordinator.asyncprepare com.arjuna.ats.arjuna.coordinator.asynccommit com.arjuna.ats.arjuna.coordinator.commitonephas e com.arjuna.ats.arjuna.coordinator.transactionsync com.arjuna.ats.arjuna.coordinator.enablestatistics com.arjuna.ats.jts.alwayspropagatecontext com.arjuna.ats.jts.defaultt imeout com.arjuna.ats.jts.supportrollbacksync com.arjuna.ats.jts.supportinterposedsynchronizati on com.arjuna.ats.jts.supportsubtransactions com.arjuna.ats.jts.checkedt ransactions com.arjuna.ats.jts.transactionmanager com.arjuna.ats.jts.needt rancontext com.arjuna.ats.arjuna.coordinator.txreapert imeo ut com.arjuna.ats.arjuna.coordinator.txreapermode com.arjuna.ats.jts.contextpropmode N'importe quelle location dans laquelle l'application peut écrire. defaultstore arjuna.properties YES/NO YES/NO YES/NO ON/OFF ON/OFF YES/NO No timeout YES/NO YES/NO YES/NO YES/NO YES/NO YES/NO microseconds NORMAL DYNAMIC NONE CONT EXT INT ERPOSIT ION 19

23 JBoss Enterprise Application Platform 5 Guide de démarrage rapide pour le développement de transactions Historique de révision Version Rüdiger Landmann Rebuild with publican Version August Ruediger Landmann Fix diacritics Version Anthony T owns Rebuild for Publican 3.0 Version Mon Jul Corina Roe T raduction française 20