Assemblage d'applications JPA pour un environnement Java EE

Vous avez développé et configuré vos applications afin de pouvoir utiliser JPA (Java™ Persistence API). Vous pouvez maintenant mettre en forme les applications JPA pour votre environnement.

Pourquoi et quand exécuter cette tâche

Procédure

Empaquetez l'application. Plusieurs options permettent de mettre en forme une application qui utilise JPA dans un environnement Java EE. Choisissez l'option de mise en forme qui convient le mieux à l'utilisation et la configuration de l'API JPA dans les modules de votre application. Voici quelques-unes des options les plus souvent utilisées. Pour obtenir une liste définitive des options de mise en forme, voir la spécification JPA (Java Persistence API).
Remarque : IBM® Optim PureQuery Runtime, ajoutez le fichier nom_unité_persistance.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. Pour plus d'informations, consultez la rubrique relative au développement d'applications JPA pour un environnement Java EE.
  • Pour qu'un module Enterprise JavaBeans (EJB) ou un module de client d'application fonctionne de manière autonome, empaquetez-le dans un fichier JAR (archive Java) standard. Assurez-vous que la mise en forme de l'application est conforme aux conditions suivantes :
    • Le fichier JAR doit contenir les fichiers de classe EJB ou Java du client d'application.
    • Le répertoire META-INF de l'archive doit comprendre votre fichier persistence.xml.
    • Si votre application utilise des fichiers de mappage, le fichier orm.xml ou un fichier de mappage personnalisé, le fichier JAR doit également contenir ces fichiers. Si l'emplacement du fichier orm.xml n'est pas indiqué dans l'unité de persistance, l'emplacement par défaut est le répertoire META-INF du fichier JAR.
    • 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 doivent être inclus dans le fichier JAR au même emplacement que les fichiers classe d'entité.
  • Dans le cas d'un module Web autonome, empaquetez l'application dans un fichier WAR standard. Assurez-vous que la mise à jour de l'application est conforme aux conditions suivantes :
    • 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 doivent être inclus dans le fichier WAR au même emplacement que les fichiers classe d'entité.
    • Le fichier WAR doit contenir vos fichiers de classes d'application Web. Ces fichiers doivent être placés dans le répertoire WEB-INF/classes ou dans un fichier JAR situé dans le répertoire WEB-INF/lib du fichier WAR.
    • Le fichier persistence.xml doit se trouver dans le répertoire WEB-INF/classes/META-INF ou dans le répertoire META-INF d'un fichier JAR situé dans le répertoire WEB-INF/lib de votre fichier WAR.
    • Si votre application utilise des fichiers de mappage, le fichier orm.xml ou un fichier de mappage personnalisé, le fichier WAR doit également contenir ces fichiers. Les fichiers de mappage peuvent résider dans le répertoire WEB-INF/classes ou dans un fichier JAR présent dans le répertoire WEB-INF/lib du fichier WAR. Utilisez l'élément <mapping-file> du fichier persistence.xml pour spécifier l'emplacement des fichiers de mappage. Exemple :
      <mapping-file>META-INF/JPAorm.xml</mapping-file>
  • Dans le cas d'une application d'entreprise contenant au moins un module, placez l'application dans un fichier EAR. Une application d'entreprise peut contenir un ou plusieurs modules EJB, modules Web ou modules de client d'application. Assurez-vous que la mise en forme de l'application est conforme aux conditions suivantes :
    • Si plusieurs modules utilisent la même unité de persistance, vous pouvez créer un fichier d'archive persistant et le placer dans le fichier EAR.
    • Le fichier d'archive persistant doit contenir les classes d'entités, les classes de métamodèles de critères associées, les éventuelles classes de prise en charge nécessaires, le fichier persistence.xml ainsi que les fichiers de mappage supplémentaires. Suivez les règles de mise en forme des modules de client d'application et modules EJB pour l'emplacement de votre fichier persistence.xml et des fichiers de mappage.
    • Chaque module utilisant une archive de persistance doit avoir une entrée de chemin de classe dans son fichier META-INF/MANIFEST.MF. Voici un exemple de fichier manifeste :
      Manifest-Version: 1.0 
      Class-Path: MyJPAEntities.jar
    • Si vos modules utilisent des unités de persistance indépendantes et partagent des classes entités, vous pouvez mettre ces dernières en forme dans un fichier d'archive persistant et spécifier d'autres fichiers persistence.xml et fichiers de mappage pour chaque module. Si les modules ne partagent pas les mêmes classes d'entité ou la même configuration de persistance, empaquetez chacun d'eux comme module EJB autonome, comme module de client d'application autonome ou comme archive d'application Web autonome, puis intégrez-les dans le fichier EAR.

Que faire ensuite

Pour plus d'informations sur les commandes, les classes ou obtenir des informations OpenJPA, voir le document Apache OpenJPA User's Guide.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tejb_assemblejpaee
Nom du fichier : tejb_assemblejpaee.html