Ensamblaje de una aplicación JPA en un entorno Java EE

Ha desarrollado y configurado sus aplicaciones para que funcionen con JPA (Java™ Persistence API). Ahora necesita empaquetar las aplicaciones JPA para su entorno.

Acerca de esta tarea

Procedimiento

Empaquetado de la aplicación. Hay varias opciones de empaquetado de una aplicación que utiliza JPA en un entorno Java EE. Seleccione la opción de empaquetado que mejor se ajuste al uso de JPA y a la configuración dentro de los módulos de la aplicación. Estas son algunas de las opciones de empaquetado más comunes. Para obtener una lista definitiva de las opciones de empaquetado, consulte la especificación de JPA (Java Persistence API).
Nota: Si utiliza IBM® Optim PureQuery Runtime, añada el archivo nombre_unidad_persistencia.pdqxml al archivo JAR de la aplicación JPA. Los archivos se encuentran en el mismo directorio META-INF donde se encuentra el archivo persistence.xml. Estos archivos de persistencia se crearon durante la tarea de desarrollo. Para obtener más información, consulte el tema Desarrollo de aplicaciones JPA para un entorno Java EE.
  • Para un módulo EJB (Enterprise JavaBeans) autónomo o un módulo de cliente de aplicación autónomo, empaquete los módulos EJB o los módulos de cliente de aplicación en un archivo JAR (Java Archive) estándar. Asegúrese de que empaqueta la aplicación con estas condiciones:
    • El archivo JAR debe contener los archivos de clases EJB o los archivos de clases Java para el cliente de aplicación.
    • El directorio META-INF del archivador debe incluir su archivo persistence.xml.
    • Si su aplicación utiliza los archivos de correlación, orm.xml, o un archivo de correlación personalizado, el archivo JAR también debe contener estos archivos. Si la ubicación del archivo orm.xml no se especifica en la unidad de persistencia, la ubicación predeterminada es el directorio META-INF del archivo JAR.
    • Los archivos de clases de metamodelos de Criteria generados por el procesador de anotaciones deben incluirse en el archivo JAR en la misma ubicación que los archivos de clases de entidad.
  • Para un módulo web autónomo, empaquete la aplicación en un archivo WAR (Web Application Archive) estándar. Asegúrese de que empaqueta la aplicación con estas condiciones:
    • Los archivos de clases de metamodelos de Criteria, generados por el procesador de anotaciones durante el desarrollo de la aplicación, deben incluirse en el archivo WAR en la misma ubicación que los archivos de clases de entidad.
    • El archivo WAR debe contener los archivos de clases de aplicación web. Los archivos de clases de aplicación web se deben incluir en el directorio WEB-INF/classes o en un archivo JAR situado en el directorio WEB-INF/lib del archivo WAR.
    • El archivo persistence.xml se debe incluir en el directorio WEB-INF/classes/META-INF o en el directorio META-INF de un archivo JAR incluido en el directorio WEB-INF/lib del archivo WAR.
    • Si su aplicación utiliza los archivos de correlación, orm.xml, o un archivo de correlación personalizado, el archivo WAR también debe contener estos archivos. Los archivos de correlación pueden residir en el directorio WEB-INF/classes o en un archivo JAR contenido en el directorio WEB-INF/lib del archivo WAR. Utilice el elemento <mapping-file> del archivo persistence.xml para especificar la ubicación de los archivos de correlación. Por ejemplo:
      <mapping-file>META-INF/JPAorm.xml</mapping-file>
  • Para la aplicación empresarial que contiene uno o más módulos, empaquete la aplicación en un archivo EAR (archivado de aplicación empresarial) estándar. Una aplicación de empresa puede contener uno o más módulos EJB, módulos web o módulos de cliente de aplicación. Asegúrese de que empaqueta la aplicación con estas condiciones:
    • Si varios módulos utilizan las misma unidad de persistencia, puede crear un archivo de persistencia y empaquetarlo dentro del archivo EAR.
    • Incluya las clases de entidades, las clases de metamodelos de Criteria asociadas, cualquier clase de soporte necesaria, el archivo persistence.xml y los archivos de correlación adicionales en el archivo archivador de persistencia. Siga las reglas de empaquetado para los módulos EJB y de cliente de aplicación en relación con la ubicación del archivo persistence.xml y de los archivos de correlación.
    • Cada módulo que utiliza el archivador de persistencia debe tener una entrada de classpath en su archivo META-INF/MANIFEST.MF. El siguiente es un archivo manifest de ejemplo:
      Manifest-Version: 1.0 
      Class-Path: MyJPAEntities.jar
    • Si los módulos utilizan unidades de persistencia diferentes y comparten clases de entidad, puede empaquetar estas clases de entidad en un archivador de persistencia y especificar un archivo persistence.xml y archivos de correlación diferentes para cada módulo. Si los módulos no comparten las clases de entidad o una configuración de persistencia, empaquete cada módulo como un módulo EJB autónomo, un módulo de cliente de aplicación autónomo o un archivador de aplicaciones web autónomo y luego empaquételos en el archivo EAR.

Qué hacer a continuación

Para obtener más información acerca de los mandatos, clases u otra información OpenJPA, consulte la Guía del Usuario de Apache OpenJPA.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tejb_assemblejpaee
File name: tejb_assemblejpaee.html