Utilisation des fournisseurs de persistance tiers
Le JPA (Java™ Persistence API) pour WebSphere Application Server prend en charge les fournisseurs de persistance tiers dans leur environnement de serveur d'applications.
Pourquoi et quand exécuter cette tâche
Les applications Java EE qui utilisent des fonctions JPA peuvent utiliser des fournisseurs de persistance tiers autres que ceux inclus dans le serveur d'applications. Elles peuvent également indiquer un fournisseur Apache OpenJPA ou EclipseLink d'une version différente de celle incluse dans le serveur d'applications, pour autant que la même version de la spécification JPA soit prise en charge.
Il existe deux moyens
principaux pour incorporer des fournisseurs tiers dans une application.
- Intégration du fournisseur de persistance dans l'application.
- Utilisation des bibliothèques partagées
Procédure
- Intégration du fournisseur de persistance tiers dans l'application. Il arrive que la conception d'une application doive dépendre de l'implémentation d'un fournisseur
de persistance spécifique. La spécification JPA autorise l'intégration d'un fournisseur
JPA spécifique dans une archive de persistance. Lors de la construction de l'application,
vous pouvez assembler une version spécifique de l'implémentation d'un fournisseur dans le fichier
EAR ou dans un fichier WAR d'application Web.
Pour intégrer un fournisseur de
persistance tiers dans une application, vous devez inspecter la conception de l'application ainsi que
toutes les exigences qui en dépendent.
Voici les étapes à suivre pour intégrer
un fournisseur de persistance dans une application.
- Modifiez l'élément <provider > pour indiquer explicitement le type de fournisseur de persistance à utiliser pour accéder à l'entité de persistance.
- Construisez/générez la version spécifique du fournisseur de persistance tiers
dans l'application. Afin de gérer correctement la persistance, vérifiez que
EntityManagerFactory et EntityManager appellent le fournisseur
approprié. De nombreux fournisseurs écrivent des informations de démarrage et de version
en sortie standard, qui vont être incluses dans le journal SystemOut.log du serveur d'applications. Ces informations peuvent être utiles pour savoir si votre application utilise ou non un fournisseur tiers.Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM® i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL en vue du traitement des incidents liés aux applications.
- Pour utiliser un fournisseur JPA tiers qui n'était pas associé au serveur d'applications, configurez d'abord le chargeur de classe de votre application pour exécuter la tâche via le chargeur de classe d'application. Cette opération est également requise si le fournisseur JPA tiers est défini dans une bibliothèque partagée affectée à un chargeur de classe défini par l'utilisateur sur le serveur. Si le chargeur de classe n'est pas correctement configuré, le fournisseur JPA tiers inclus dans le serveur d'applications n'est ni chargé, ni utilisé par votre application.
- En fonction de la manière dont vous avez intégré le fournisseur, choisissez l'une des procédures suivantes :
- Si le fournisseur se trouve dans un fichier EAR, indiquez les fichiers binaires du fournisseur de persistance tiers dans le chemin d'accès à la classe Manifest.mf se trouvant dans les modules d'application requérant l'accès JPA.
- Si le fournisseur était fourni dans un fichier WAR, incluez les fichiers binaires nécessaires dans le répertoire WEB-INF/lib de l'application Web.
- Installez votre application en suivant les procédures normales
- Utilisation des bibliothèques partagées pour l'implémentation d'un
fournisseur de persistance tiers Les fournisseurs de persistance dont l'accès est possible via des applications dans un environnement global peuvent être installés en tant que bibliothèque partagée du serveur
d'applications. Vous pouvez partager la bibliothèque entre le serveur et l'application,
en fonction de vos exigences. Voici les étapes à suivre pour implémenter
un fournisseur de persistance tiers à l'aide des bibliothèques partagées.
- Modifiez l'élément <provider > pour indiquer explicitement le type de fournisseur de persistance à utiliser pour accéder à l'entité de persistance.
- Définissez le fournisseur de persistance dans une bibliothèque partagée. Pour plus d'informations, voir la rubrique relative à la création de bibliothèques partagées
- Associez la bibliothèque partagée avec le chargeur de classe d'applications, ou associez-la au chargeur de classe du serveur si plusieurs applications peuvent accéder à la bibliothèque.
- Configurez d'abord le chargeur de classe de votre application pour exécuter la tâche via le chargeur de classe d'application. Cela est également requis si le fournisseur JPA tiers est inclus dans l'application ou s'il est défini dans une bibliothèque partagée. Si la configuration du chargeur de classe n'est pas appropriée, le fournisseur JPA inclus dans le serveur d'applications est utilisé par votre application à la place du fournisseur JPA tiers.
- Un fournisseur de persistance de bibliothèque partagée peut remplacer un fournisseur de persistance du même type existant dans la hiérarchie du chargeur de classe de votre application. Si un fournisseur de persistance de bibliothèque partagée remplace le fournisseur fourni avec le produit, nous vous recommandons d'utiliser un chargeur de classe isolé pour la bibliothèque partagée. Pour plus d'informations, voir la rubrique relative à la création de bibliothèques partagées.


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tejb_jpa3rdparty
Nom du fichier : tejb_jpa3rdparty.html