Support JTA

Interface SynchronizationCallback

Un objet implémentant cette interface est répertorié une fois dans l'interface ExtendedJTATransaction et il reçoit la notification de réalisation des transactions.

Bien qu'un objet implémentant cette interface puisse s'exécuter sur une plateforme Java pour un serveur d'applications d'entreprise, aucun composant d'application d'entreprise spécifique n'est actif lorsque cet objet est appelé. Ainsi, l'objet possède un accès direct limité aux ressources d'application d'entreprise. En particulier, l'objet n'a pas accès à l'espace de noms java: ou à une ressource utilisée par le conteneur. Ce type d'objet peut placer en mémoire cache une référence à un composant d'application d'entreprise (par exemple, un bean session sans état) auquel il effectue une délégation. L'objet possède alors tous les droits d'accès habituels aux ressources d'application d'entreprise. Par exemple, vous pouvez utiliser l'objet pour acquérir une connexion JDBC (JDBC) et vider les mises à jour d'une base de données lors de la méthode beforeCompletion.

Interface ExtendedJTATransaction

Cette interface est une extension de modèle de programmation WebSphere® pour la prise en charge JTA Java EE . Un objet implémentant cette interface est lié, par des conteneurs d'application d'entreprise dans WebSphere Application Server qui prennent en charge cette interface, à java:comp/websphere/ExtendedJTATransaction. L'accès à cet objet, lorsqu'il est appelé dans un conteneur EJB (Enterprise JavaBeans), n'est pas restreint aux transactions gérées par composant.

ExtendedJTATransaction exJTA = (ExtendedJTATransaction)ctx.lookup("
	java:comp/websphere/ExtendedJTATransaction");
SynchronizationCallback sync = new SynchronizationCallback();
exJTA.registerSynchronizationCallback(sync);

Interface TransactionSynchronizationRegistry

Cette interface est définie dans la spécification JTA 1.1. Les composants d'application au niveau du système, tels que les gestionnaires de persistance, les adaptateurs de ressources, les beans entreprise et les composants d'applications Web, peuvent utiliser cette interface pour s'enregistrer dans une transaction JTA. Ensuite, par exemple, le composant peut vider un cache à la fin d'une transaction.

Pour obtenir l'interface TransactionSynchronizationRegistry, utilisez interface, use une consultation JNDI de java:comp/TransactionSynchronizationRegistry.

Interface UOWSynchronizationRegistry

Pour vous procurer l'interface UOWSynchronizationRegistry, recourez à une consultation JNDI de java:comp/websphere/UOWSynchronizationRegistry. Cette interface est disponible uniquement dans un environnement de serveur.

// Retrieve an instance of the UOWSynchronizationRegistry interface from JNDI.
final InitialContext initialContext = new InitialContext();
final UOWSynchronizationRegistry uowSyncRegistry =
		(UOWSynchronizationRegistry)initialContext.lookup("java:comp/websphere/UOWSynchronizationRegistry");

// Instantiate a class that implements the javax.transaction.Synchronization interface
final Synchronization sync = new SynchronizationImpl();

// Register the Synchronization object with the current UOW.
uowSynchronizationRegistry.registerInterposedSynchronization(sync);

Interface UOWManager

L'interface UOWManager équivaut à celle JTA TransactionManager, qui définit les méthodes permettant à un serveur d'applications de gérer les limites des transactions. Les applications peuvent utiliser l'interface UOWManager pour manipuler des contextes UOW dans le produit. L'interface UOWManager s'applique à tous les types d'unité de travail que WebSphere Application Server prend en charge, à savoir des transactions JTA, des confinements de transaction locale et des contextes ActivitySession. Le code d'application peut s'exécuter dans un type particulier d'unité de travail sans qu'il soit nécessaire d'utiliser un bean enterprise configuré en conséquence. En général, la logique qui est exécutée dans la portée de l'unité de travail est encapsulée dans une classe intérieure anonyme. Les composants de serveur d'applications au niveau du système, tels que les gestionnaires de persistance, les adaptateurs de ressources, les beans enterprise et les composants d'applications Web, peuvent utiliser cette interface.

WebSphere Application Server ne fournit pas d'interface TransactionManager dans l'API ou l'interface de programmation système (SPI). L'interface UOWManager fournit des fonctions équivalentes, mais WebSphere Application Server conserve le contrôle et l'intégrité des contextes d'unité de travail.

Pour vous procurer l'interface UOWManager dans un environnement géré par conteneur, recourez à une consultation JNDI de java:comp/websphere/UOWManager. Pour obtenir l'interface UOWManager en dehors d'un environnement géré par conteneur, utilisez la classe UOWManagerFactory. Cette interface est disponible uniquement dans un environnement de serveur.

Vous pouvez utiliser l'interface UOWManager pour migrer une application Web afin d'utiliser des composants Web au lieu de beans enterprise tout en conservant le contrôle des unités de travail. Par exemple, une application Web utilise actuellement l'interface UserTransaction pour démarrer une transaction globale, appelle une méthode dans un bean enterprise de session configuré comme non pris en charge pour exécuter une tâche non transactionnelle, puis exécute la transaction globale. Vous pouvez déplacer la logique qui est encapsulée dans la méthode du bean enterprise de session vers la méthode d'exécution d'une implémentation UOWAction. Ensuite, vous remplacez le code dans le composant Web appelant le bean enterprise de session par un appel de la méthode runUnderUOW d'une interface UOWManager, afin que cette logique soit exécutée dans une transaction locale. De cette façon, vous conservez le même niveau de contrôle sur les unités de travail qu'avec l'application d'origine.

// Retrieve an instance of the UOWManager interface from JNDI.
final InitialContext initialContext = new InitialContext();
final UOWManager uowManager = (UOWManager)initialContext.lookup("java:comp/websphere/UOWManager");

try
{
	// Invoke the runUnderUOW method, indicating that the logic should be run in a global 
	// transaction, and that any existing global transaction should not be joined, that is, 
	// the work must be performed in the scope of a new global transaction.
	uowManager.runUnderUOW(UOWSynchronizationRegistry.UOW_TYPE_GLOBAL_TRANSACTION, false, new UOWAction()
	{
 		public void run() throws Exception
 		{
			// Perform transactional work here.
 		}
	});
}

catch (UOWActionException uowae)
{
	// Transactional work resulted in a checked exception being thrown.
}

catch (UOWException uowe)
{
	// The completion of the UOW failed unexpectedly. Use the getCause method of the 
	// UOWException to retrieve the cause of the failure.
}