11.5.2. Cycle de vie d'une transaction JTA

Pour démarrer une transaction, votre application doit obtenir une instance de la classe UserTransaction du JNDI ou bien, s'il s'agit d'un EJB, en provenance d'une annotation. L'interface UserTransaction comprend des méthodes pour commencer, valider, ou annuler des transactions au plus haut niveau. Les transactions nouvellement créées sont associées automatiquement à leur thread invoquant. Les transactions imbriquées ne sont pas supportées dans JTA, donc toutes les transactions sont des transactions au plus haut niveau.

En appelant UserTransaction.begin() avec des annotations démarre une transaction quand une méthode EJB est appelée (bassée sur des règles d'attributs de transaction). Toute ressource qui est utilisée après cela sera associée à la transaction. S'il y a plus plus d'une seule ressource listée, votre transaction devient une transaction XA, et participera au protocole de validation en deux temps.

Dans l'étape suivante, votre application effectue son travail et précède aux changements d'état.

Quand votre application a fini de changer d'état, elle décide si elle doit valider ou s'annuler. Elle appelle la méthode qui convient. Elle appelle UserTransaction. commit() ou UserTransaction.rollback().

Après la validation ou l'annulation, le gestionnaire de transactions nettoie ses archives et supprime les informations du journal de transaction sur votre transaction.