Traitement des transactions dans les applications Java EE

[Java programming language only] WebSphere eXtreme Scale fournit son propre adaptateur de ressources, que vous pouvez utiliser pour connecter des applications à la grille de données et traiter les transactions locales.

Grâce au support de l'adaptateur de ressources eXtreme Scale, les applications Java™ Platform, Enterprise Edition (Java EE) peuvent rechercher les connexions client eXtreme Scale et démarquer les transactions locales à l'aide des transactions Java EE locales ou des API eXtreme Scale. Lorsque l'adaptateur de ressources est configuré, vous pouvez exécuter les actions suivantes avec vos applications Java EE :

Rechercher ou injecter les fabriques de connexions d'adaptateur de ressources eXtreme Scale dans un composant d'application Java EE.
Obtenir des descripteurs de connexions standard pour le client eXtreme Scale et les partager entre les composants d'application à l'aide de conventions Java EE.
Démarquer les transactions eXtreme Scale à l'aide de l'API javax.resource.cci.LocalTransaction ou de l'interface com.ibm.websphere.objectgrid.Session.
Utiliser l'API client eXtreme Scale dans sa totalité, par exemple, l'API ObjectMap et l'API EntityManager.

Les fonctions supplémentaires suivantes sont disponibles avec WebSphere Application Server :

Inscrivez les connexions eXtreme Scale avec une transaction globale en tant que dernier participant avec d'autres ressources de validation en deux phases. L'adaptateur de ressources eXtreme Scale fournit un support pour les transactions locales, avec une ressource de validation en une phase. WebSphere Application Server permet aux applications d'inscrire une ressource de validation en une phase dans une transaction globale à l'aide du support LPS (Last Participant Support).
Installation automatique d'adaptateur de ressources lorsque le profil est étendu.
Propagation automatique du principal de sécurité.

Responsabilités de l'administrateur

L'adaptateur de ressources eXtreme Scale est installé sur le serveur d'applications Java EE ou intégré à l'application. Après avoir installé l'adaptateur de ressources, l'administrateur crée une ou plusieurs fabriques de connexions d'adaptateur de ressources pour chaque domaine de service de catalogue et, éventuellement, chaque instance de grille de données. La fabrique de connexions identifie les propriétés requises pour communiquer avec la grille de données.

Les applications font référence à la fabrique de connexions, qui établit la connexion à la grille de données distante. Chaque fabrique de connexions héberge une connexion client eXtreme Scale unique qui est réutilisée pour tous les composants d'application.

Important : Etant donné que la connexion client eXtreme Scale peut inclure un cache local, les applications ne doivent pas partager de connexion. Il doit exister une fabrique de connexions pour chaque instance d'application pour éviter tout problème de partage d'objets entre les applications.

La fabrique de connexions héberge une connexion client eXtreme Scale qui est partagée entre tous les composants d'applicaton qui y font référence. Vous pouvez utiliser un bean géré (MBean) pour accéder aux informations sur la connexion client ou réinitialiser la connexion qui n'est plus nécessaire.

Responsabilités du développeur d'applications

Un développeur d'applications crée les références de ressource pour les fabriques de connexions gérées dans le descripteur de déploiement d'application ou à l'aide d'annotations. Chaque référence de ressource inclut une référence locale pour la fabrique de connexions eXtreme Scale, ainsi que la portée de partage de ressources.

Important : L'activation du partage des ressources est important car il permet de partager la transaction locale entre les composants d'application.

Les applications peuvent injecter la fabrique de connexions dans le composant d'application Java EE ou la rechercher à l'aide de JNDI. La fabrique de connexions est utilisée pour obtenir des descripteurs de connexion concernant la connexion client eXtreme Scale. La connexion client eXtreme Scale est gérée indépendamment de la connexion à l'adaptateur de ressources et elle est établie lors de la première utilisation, puis réutilisée pour toutes les connexions suivantes.

Après avoir trouvé la connexion, l'application extrait une référence de session eXtreme Scale. Cette référence de session eXtreme Scale permet à l'application d'utiliser toutes les API et fonctions du client eXtreme Scale.

Vous pouvez démarquer les transactions de plusieurs façons :

Utilisez les méthodes de démarcation de transaction com.ibm.websphere.objectgrid.Session.
Utilisez la transaction locale javax.resource.cci.LocalTransaction.
Utilisez une transaction globale, lorsque vous utilisez WebSphere Application Server en ayant activé le support LPS (Last Participant Support). Dans ce cas, vous devez :
- Utiliser une transaction globale gérée par application avec javax.transaction.UserTransaction.
- Utiliser une transaction gérée par conteneur.

Responsabilités du déployeur d'applications

Le déployeur d'applications lie la référence locale à la fabrique de connexions de l'adaptateur de ressources que le développeur d'applications définit aux fabriques de connexions de l'adaptateur de ressources que l'administrateur définit. Le déployeur d'applications doit attribuer à l'application la portée et le type corrects de la fabrique de connexions et s'assurer que la fabrique de connexions n'est pas partagée entre les applications pour éviter le partage d'objets Java. Le déployeur d'applications est également chargé de configurer et de mapper les autres informations de configuration appropriées communes à toutes les fabriques de connexions.