des enterprise beans - Département Informatique

Utilisation de l’ API de transaction
transaction globale et que les attributs de transaction sont définis pour les
transactions gérées par le conteneur. Le conteneur enveloppe
automatiquement un appel de méthode à l’intérieur d’une transaction
locale si une des conditions suivantes est vrai :
• L’attribut de transaction est défini par NotSupported et le conteneur
détecte que les ressources de bases de données ont été accédées.
• L’attribut de transaction est défini par Supports et le conteneur détecte
que la méthode n’a pas été invoquée depuis l’intérieur d’une
transaction globale.
• L’attribut de transaction est défini par Never et le conteneur détecte
que les ressources de bases de données ont été accédées.
Utilisation de l’API de transaction
Toutes les transactions utilisent l’API JTA (Java Transaction API). Lorsque
les transactions sont gérées par le conteneur, la plate-forme gère la
démarcation des transactions et le conteneur utilise l’API JTA. Vous
n’avez jamais besoin d’utiliser cette API dans le code de votre bean.
Si votre bean gère lui-même ses transactions, il doit utiliser l’interface JTA
javax.transaction.UserTransaction. Cette interface permet à un client ou à
un composant de démarquer les limites des transactions. Les enterprise
beans dont les transactions sont gérées par le bean utilisent la méthode
EJBContext.getUserTransaction().
De plus, tous les clients transactionnels utilisent JNDI pour consulter
l’interface UserTransaction. Vous faites cela en construisant un
InitialContext JNDI à l’aide du service d’annuaire JNDI, comme indiqué
ici :
javax.naming.Context context = new javax.naming.InitialContext();
Une fois que le bean a obtenu l’objet InitialContext, il peut utiliser
l’opération JNDI lookup() pour obtenir l’interface UserTransaction :
javax.transaction.UserTransaction utx = (javax.transaction.UserTransaction)
context.lookup("java:comp/UserTransaction")
Notez qu’un enterprise bean peut obtenir une référence à l’interface
UserTransaction depuis l’objet EJBContext. Le bean peut simplement utiliser
la méthode EJBContext.getUserTransaction() au lieu de chercher à obtenir
un objet InitialContext et d’utiliser ensuite la méthode JNDI lookup().
Mais, si le client transactionnel n’est pas un enterprise bean, il doit utiliser
l’approche de recherche JNDI.
Quand le bean ou le client détient la référence à l’interface UserTransaction,
il peut alors initier et gérer ses propres transactions. C’est-à-dire que vous
pouvez utiliser les méthodes de l’interface UserTransaction pour
commencer et valider (ou annuler) des transactions. Vous utilisez la
13-6 Guide du dé veloppeur Enterprise JavaBeans