Vous avez développé et configuré vos applications afin de pouvoir utiliser
JPA (Java™ Persistence
API). Vous devez maintenant mettre en forme les applications JPA pour votre environnement.
Pourquoi et quand exécuter cette tâche
Pour cette tâche, vous devez spécifier le fichier JAR (Java archive) autonome com.ibm.ws.jpa-2.1.thinclient_9.0.jar pour les applications JPA 2.1 ou le fichier com.ibm.ws.jpa-2.0.thinclient_9.0.jar dans votre chemin d'accès aux classes. Ce fichier JAR autonome est accessible via les images d'installation du client et du serveur. L'emplacement de ces fichiers JAR sur l'image d'installation client est le répertoire ${app_client_root}/runtimes/. L'emplacement de ces fichiers sur l'image d'installation du serveur est le répertoire ${app_server_root}/runtimes/.
Procédure
- Empaquetez l'application.
Remarque : Effectuez la mise en forme des unités de persistance dans des fichiers JAR individuels afin qu'elles soient réutilisables et plus faciles d'accès. Si vous mettez en forme les unités de persistance de cette manière, elles peuvent être testées hors du conteneur avec ou sans l'occurrence de la persistance de base de données. Les unités de persistance peuvent être incluses dans les applications autonomes ou être empaquetées dans les
fichiers EAR en tant que fichiers d'archive de persistance. Si vous effectuez la mise en forme de l'unité de persistance
dans un fichier d'archive persistant, tous les composants de l'application
doivent pouvoir accéder au fichier d'archive persistant. L'application qui utilise
les unités de persistance doit déclarer une dépendance par rapport au fichier d'archive persistant via la déclaration
MANIFEST.MF Class-Path:.
Les fichiers classe
de métamodèle de critères générés par l'élément Annotation Processor
lors du développement de l'application JPA doivent être inclus dans le fichier
JAR au même emplacement que les fichiers classe d'entité.
Remarque : Si vous utilisez WSJPA et le module d'exécution d'IBM®
Optim PureQuery, ajoutez les fichiers persistence_unit_name.pdqxml au fichier JAR de l'application JPA. Les fichiers sont situés dans le même répertoire META-INF que votre fichier persistence.xml. Ces fichiers de persistance ont été créés lors de la tâche de développement, Développement des applications JPA pour un environnement Java SE.
Pour mettre en forme l'application, utilisez la commande suivante :jar -cvf ${jar_Name} ${entity_Path}
où ${jar_Name} représente le nom du fichier JAR à créer, et ${entityPath} l'emplacement racine des entités, c'est-à-dire l'endroit où vous les avez compilées.
Assurez-vous que l'emplacement ${entity_Path} contient également le fichier META-INF/persistence.xml.
- Lorsque vous exécutez votre application autonome, spécifiez les fichiers JAR dans le chemin d'accès aux classes chemin d'accès lors du démarrage de l'application. Le module d'exécution JPA démarre l'un des fichiers JAR autonomes, com.ibm.ws.jpa-2.1.thinclient_9.0.jar ou
com.ibm.ws.jpa-2.0.thinclient_9.0.jar. Par exemple, utilisez l'appel Java suivant pour exécuter l'application autonome com.xyz.Main :
java -cp /your/directory/${jar_Name}
-javaagent:${app_client_root}/runtimes/com.ibm.ws.jpa-2.1.thinclient_9.0.jar com.xyz.Main