Plug-in WebSphereTransactionCallback

Deprecated feature L'utilisation du plug-in WebSphereTransactionCallback permet aux applications d'entreprise qui s'exécutent en environnement WebSphere Application Server de gérer les transactions ObjectGrid. Ce plug-in est obsolète. Utilisez l'adaptateur de ressources WebSphere eXtreme Scale à la place.

Deprecated feature L'interface WebSphereTransactionCallback a été remplacée par l'adaptateur de ressources WebSphere eXtreme Scale qui permet la gestion des transactions JTA (Java Transaction API). Vous pouvez installer cet adaptateur de ressources sur WebSphere Application Server ou d'autres serveurs d'applications Java Platform, Enterprise Edition (Java EE). Le plug-in WebSphereTransactionCallback n'est pas une API JTA inscrite et, par conséquent, il n'est pas conçu pour annuler la transaction JTA en cas de validation.

Lorsqu'on utilise une session ObjectGrid au sein d'une méthode configurée pour utiliser des transactions gérées par conteneur, le conteneur d'entreprise automatiquement commence, valide ou annule la transaction ObjectGrid. Lorsqu'on utilise des objets UserTransaction de l'API Java Transaction (JTA), la transaction ObjectGrid est gérée automatiquement par l'objet UserTransaction.

Pour une discussion détaillée de l'implémentation de ce plug-in, voir Gestionnaire de transactions externes.

Remarque : L'ObjectGrid ne prend pas en charge les transactions à 2 phases ou transactions XA. Ce plug-in n'enregistre pas la transaction ObjectGrid auprès du gestionnaire de transactions. Il en résulte que, si l'ObjectGrid ne parvient pas à valider, les autres ressources gérées par la transaction XA ne sont pas annulées.

Configuration par programmation du plug-in WebSphereTransactionCallback

L'activation de WebSphereTransactionCallback dans la configuration d'ObjectGrid peut se faire par programmation ou par configuration XML. Le fragment de code suivant utilise l'application pour créer l'objet WebSphereTransactionCallback et l'ajouter à un ObjectGrid :

ObjectGridManager objectGridManager = ObjectGridManagerFactory.getObjectGridManager();
ObjectGrid myGrid = objectGridManager.createObjectGrid("myGrid", false);
WebSphereTransactionCallback wsTxCallback= new WebSphereTransactionCallback ();
myGrid.setTransactionCallback(wsTxCallback);

Configuration par XML du plug-in WebSphereTransactionCallback

La configuration XML suivante crée l'objet WebSphereTransactionCallback et l'ajoute à un ObjectGrid. Le texte suivant doit se trouver dans le fichier myGrid.xml :

<?xml version="1.0" encoding="UTF-8"?>
<objectGridConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ibm.com/ws/objectgrid/config ../objectGrid.xsd"
    xmlns="http://ibm.com/ws/objectgrid/config">
    <objectGrids>
        <objectGrid name="myGrid">
            <bean id="TransactionCallback" className=
	"com.ibm.websphere.objectgrid.plugins.builtins.WebSphereTransactionCallback" />

        </objectGrid>
    </objectGrids>
</objectGridConfig>