JPA-Projekte erstellen
Mit dem Assistenten "JPA-Projekt" können Sie ein JPA-Projekt erstellen und konfigurieren.
Informationen zu diesem Vorgang
Vorgehensweise
- Klicken Sie in der JPA-Perspektive auf Datei > Neu > Projekt > JPA-Projekt.
- Geben Sie im Feld Projektname einen Namen für das neue Projekt ein.
- Um die Standardposition des Projekts zu ändern, wählen Sie das Kontrollkästchen Standardwert verwenden unter Projektinhalt ab und wählen Sie über die Schaltfläche Durchsuchen eine neue Position aus.
- Wählen Sie im Feld Ziellaufzeit die Ziellaufzeitumgebung für das Projekt aus. Wenn Sie zuvor ein Projekt erstellt und eine Ziellaufzeitumgebung festgelegt haben, ist dieses Feld inaktiviert.
- Wählen Sie die JPA-Version aus, die für das Projekt verwendet werden soll.
- Wählen Sie unter Konfigurationen die Option Minimalkonfiguration aus.
- Optional: Um das neue Projekt zu einer EAR-Datei hinzuzufügen, wählen Sie das
Kontrollkästchen Modul zu einer EAR-Anwendung hinzufügen aus. Geben Sie einen neuen Projektnamen ein oder wählen Sie ein vorhandenes Unternehmensanwendungsprojekt
in der Liste EAR-Projekt aus. Alternativ können Sie auch auf Neu klicken, um den Assistenten "Neues EAR-Anwendungsprojekt" zu starten. Anmerkung: Wenn Sie den Namen eines neuen EAR-Projekts eingeben, wird das EAR-Projekt mit der für diese Version niedrigsten kompatiblen J2EE-Version an der Standardposition erstellt. Falls Sie eine andere Version oder eine andere Position für die Unternehmensanwendung angeben möchten, müssen Sie den Assistenten "Neues Unternehmensanwendungsprojekt" verwenden.
- Klicken Sie auf Weiter.
- Wählen Sie bei Bedarf Quellenordner im Erstellungspfad aus oder fügen Sie weitere Ordner hinzu, indem Sie auf Ordner hinzufügen klicken, und legen Sie den Standardausgabeordner fest oder übernehmen Sie den standardmäßig angegebenen Ordner. Klicken Sie auf Weiter.
- Führen Sie auf der Seite JPA-Facette die folgenden Schritte aus:
- Wählen Sie die richtige Plattform aus.
- Wählen Sie in der JPA-Implementierung den Typ "Durch Ziellaufzeit bereitgestellte Bibliothek" aus.
- Wählen Sie die gewünschte Datenbankverbindung für dieses Projekt aus oder klicken Sie
auf Verbindung hinzufügen, um eine neue Verbindung zu erstellen. Anmerkung: Es muss eine aktive Datenbankverbindung bestehen, damit Sie Entitäten zu Datenbanktabellen zuordnen oder JPA-Entitäten aus einer vorhandenen Datenbank generieren können.
- Wählen Sie bei Verwaltung von permanenten Klassen aus, ob Klassen mit Annotationen automatisch erkannt werden sollen oder in der Datei persistence.xml aufgelistet sein müssen.
- Wenn Sie die Datei orm.xml automatisch erstellen lassen möchten, wählen Sie die Option orm.xml erstellen aus. In der Datei
orm.xml können Sie die in Java-Klassen mit JPA-Annotationen angegebenen Details für die objektbezogene Zuordnung
außer Kraft setzen.
Die Datei orm.xml befindet sich im Verzeichnis META-INF
des Projekts. Warnung: WebSphere Application Server Traditional Version 9 unterstützt JPA 2.0 und JPA 2.1. Die JPA-Version, die Sie in Ihrem Projekt verwenden, muss mit der JPA-Version, die Sie in Ihrer Installation von WebSphere Application Server Traditional Version 9 verwenden, übereinstimmen. Stimmen diese Versionen nicht überein, zeigen die Tools eine Warnung an, wenn Sie Ihr Projekt auf dem Server implementieren.Wenn Sie ein JPA 2.0-Projekt erstellen, geben die Tools die folgenden Dateien im Klassenpfadcontainer an:
com.ibm.ws.jpa.jar com.ibm.ws.jpa.container20.jar javax.j2ee.persistence.2.0.jarWenn Sie ein JPA 2.1-Projekt erstellen, geben die Tools die folgenden Dateien im Klassenpfadcontainer an:com.ibm.ws.jpa.eclipselink.jar com.ibm.ws.jpa.container21.jar javax.j2ee.persistence.jar
- Klicken Sie auf Fertigstellen.
Übergeordnetes Thema: JPA-Anwendungen entwickeln