Ha desarrollado y configurado sus aplicaciones para que funcionen con JPA (Java™ Persistence
API). Ahora debe empaquetar las aplicaciones JPA para su entorno.
Acerca de esta tarea
Para esta tarea, debe especificar el archivo
com.ibm.ws.jpa-2.1.thinclient_9.0.jar, archivo
de archivado Java (JAR)
autónomopara aplicaciones JPA 2.1, o el archivo
com.ibm.ws.jpa-2.0.thinclient_9.0.jar en la vía
de acceso de clase. Este archivo JAR autónomo está disponible en las imágenes de instalación del cliente y del servidor. La
ubicación de estos archivos .jar en la imagen de instalación del
cliente está en el dirtectorio ${raíz_cliente_apl}/runtimes/. La
ubicación de estos archivos en la imagen de instalación del
servidor es el directorio ${raíz_servidor_apl}/runtimes/.
Procedimiento
- Empaquetado de la aplicación.
Nota: Empaquete las
unidades de persistencia en archivos JAR separados para que resulte más fácil su acceso y
su reutilización. Si empaqueta las unidades de persistencia de este modo, se podrán probar fuera del contenedor con y sin la presencia de la persistencia de base de datos. Las unidades de persistencia se pueden incluir en aplicaciones autónomas, o bien empaquetarse en archivos EAR
como archivos de archivado de persistencia. Si empaqueta la
unidad de persistencia en un archivo archivador de persistencia, todos los componentes de
aplicación deben poder acceder al archivador de persistencia. La aplicación que utiliza
las unidades de persistencia debe declarar una dependencia en el archivador de
persistencia utilizando la declaración
MANIFEST.MF Class-Path:.
Los archivos de clases de metamodelos de Criteria, generados por el procesador de anotaciones cuando ha desarrollado su aplicación JPA, deben incluirse en el archivo JAR en la misma ubicación que los archivos de clases de entidad.
Nota: Si
está utilizando WSJPA e IBM®
Optim PureQuery Run time,
añada los archivos
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 denominada Desarrollo de aplicaciones JPA para un entorno Java SE.
Para empaquetar la aplicación utilice el mandato siguiente: jar -cvf
${nombre_jar} ${vía_acceso_entidades}
donde
${nombre_jar} representa el nombre del archivo JAR que se ha de crear
y ${vía_acceso_entidades} representa la ubicación raíz en la que
residen
las entidades, que es donde las ha empaquetado.
Asegúrese de que ${entity_Path} también contenga el archivo META-INF/persistence.xml.
- Cuando ejecute la aplicación autónoma, especifique los archivos JAR en la classpath al iniciar la aplicación. El tiempo de ejecución JPA inicia uno de los archivos JAR
autónomos, com.ibm.ws.jpa-2.1.thinclient_9.0.jar o
com.ibm.ws.jpa-2.0.thinclient_9.0.jar. Por ejemplo, utilice la siguiente invocación Java para ejecutar la aplicación autónoma com.xyz.Main:
java -cp /your/directory/${jar_Name}
-javaagent:${raíz_cliente_apl}/runtimes/com.ibm.ws.jpa-2.1.thinclient_9.0.jar
com.xyz.Main