Sie haben Ihre Anwendung entwickelt und für die Verwendung mit JPA
(Java™ Persistence API) konfiguriert. Jetzt
müssen Sie die JPA-Anwendungen für Ihre Umgebung packen.
Informationen zu diesem Vorgang
Für diese Task müssen Sie die eigenständige JAR-Datei
com.ibm.ws.jpa-2.1.thinclient_9.0.jar
für JPA 2.1-Anwendungen bzw. die JAR-Datei
com.ibm.ws.jpa-2.0.thinclient_9.0.jar in Ihrem Klassenpfad angeben.
Diese eigenständige JAR-Datei ist in den Installationsimages für Client und Server verfügbar. Diese JAR-Dateien befinden
sich im Clientinstallationsimage im Verzeichnis ${app_client_root}/runtimes/. Diese Dateien befinden sich im Serverinstallationsimage im Verzeichnis ${Stammverzeichnis_des_Anwendungsservers}/runtimes/.
Vorgehensweise
- Packen Sie die Anwendung.
Anmerkung: Packen Sie
die Persistenzeinheiten in separate JAR-Dateien, damit sie
besser zugänglich und wiederverwendbar sind.
Wenn Sie die Persistenzeinheiten auf diese Art und Weise packen,
können sie sowohl bei Auftreten der Datenbankpersistenz als auch bei fehlender
Datenbankpersistenz außerhalb des Containers getestet werden.
Persistenzeinheiten können
in eigenständige Anwendungen aufgenommen oder als Persistenzarchivdateien in EAR-Dateien gepackt werden.
Wenn Sie die Persistenzeinheit in eine Persistenzarchivdatei packen, müssen alle Anwendungskomponenten
auf das Persistenzarchiv zugreifen können.
Die Anwendung, die die Persistenzeinheiten verwendet, muss
mit der Deklaration
MANIFEST.MF Class-Path: eine Abhängigkeit vom Persistenzarchiv deklarieren.
Die Klassendateien des Criteria Metamodel, die bei der Entwicklung der JPA-Anwendung
vom Annotationsprozessor generiert werden, müssen an derselben Position in die JAR-Datei aufgenommen werden wie die Entitätsklassendateien.
Anmerkung: Wenn Sie WSJPA und
IBM®
Optim PureQuery Run Time verwenden, fügen Sie die Dateien
Name_der_Persistenzeinheit.pdqxml der JAR-Datei der JPA-Anwendung hinzu.
Die Dateien befinden sich in demselben Verzeichnis META-INF wie Ihre Datei persistence.xml.
Diese Persistenzdateien wurden während der Entwicklungstask "JPA-Anwendungen für eine Java-SE-Umgebung entwickeln"
erstellt.
Verwenden Sie zum Packen der Anwendung den folgenden Befehl:
jar -cvf ${JAR-Name} ${Entitätspfad}
Dabei
stellt ${JAR-Name} den Namen der zu erstellenden JAR-Datei dar, und
${Entitätspfad} das Stammverzeichnis, in dem sich die Entitäten befinden, d. h. in dem sie kompiliert wurden.
Stellen Sie sicher, dass Ihr ${Entitätspfad} auch die Datei
META-INF/persistence.xml enthält.
- Wenn Sie Ihre eigenständige Anwendung ausführen, geben Sie beim Starten der Anwendung
die JAR-Dateien in Ihrem Klassenpfad an. Die JPA-Laufzeit startet eine der eigenständigen JAR-Dateien
com.ibm.ws.jpa-2.1.thinclient_9.0.jar oder
com.ibm.ws.jpa-2.0.thinclient_9.0.jar. Verwenden Sie beispielsweise den folgenden Java-Aufruf, um die eigenständige
Anwendung "com.xyz.Main" auszuführen:
java -cp /Ihr/Verzeichnis/${JAR-Name}
-javaagent:${Stammverzeichnis_des_Anwendungsclients}/runtimes/com.ibm.ws.jpa-2.1.thinclient_9.0.jar com.xyz.Main