EclipseLink – JPA-Installation und -Konfiguration mit Eclipse

In diesem Artikel erfahren Sie, wie Sie EclipseLink-JPA installieren und verwenden können. Die in diesem Installationshandbuch verwendete integrierte Entwicklungsumgebung ist „Eclipse Java EE IDE for Web Developers – Kepler Service Release 1“.

Installieren Sie die Eclipse-IDE

Zunächst sollten Sie die Eclipse-IDE von der offiziellen Eclipse-Website installieren. Öffnen Sie Eclipse nach Abschluss der Installation. Dieses Tutorial verwendet die Kepler-Version der Eclipse-IDE. Die Ansicht der Eclipse-IDE sollte wie in Abbildung 1-1 dargestellt sein.

EclipseIDE-Willkommen

Abbildung 1.1

Installieren Sie EclipseLink-JAR-Dateien

  • Laden Sie EclipseLink 2.5.1 Installer Zip von der Website der Eclipse-Organisation herunter oder folgen Sie diesem Link https://www.eclipse.org/eclipselink/downloads/ Verknüpfung. Das enthält die Implementierung für alle Persistenzdienste, die EclipseLink bietet.
  • Die JAR-Dateien, die für den JPA-Persistenzdienst verwendet werden sollten, sind:
  • eclipselink.jar
  • javax.persistence.source_2.1.0.v201304241213.jar
  • javax.persistence_2.1.0.v201304241213.jar
    • Entpacken Sie die Datei in ein beliebiges Verzeichnis, das Sie zum Abschließen der Installation verwenden würden. Wir haben die Datei bereits in den Ordner „C:/JavaBeat“ entpackt.

    Legen Sie die JPA-Facette in der Eclipse-IDE fest

    Erstellen Sie ein dynamisches Eclipse-Projekt und bereiten Sie es für das Hinzufügen einer JPA-Facette vor. Folge den Schritten:

  • Öffnen Sie eine Eclipse-IDE.
  • Erstellen Sie ein dynamisches Projekt.
  • Klicken Sie mit der rechten Maustaste auf das erstellte Projekt. Wählen Sie Eigenschaften aus.
  • Klicken Sie auf die Projektfacetten.
  • Aktivieren Sie die JPA-Option und wählen Sie JPA Version 2.1. Siehe Abbildung .1.2.
  • Dynamisch-Projekt-erstellt

    Abbildung 1.2

    Es ist eine weitere Konfiguration erforderlich. Schließen Sie diese daher ab, indem Sie auf die unten angezeigte Fehlermeldung „Weitere Konfiguration erforderlich“ klicken. Diese Aktion sollte einen neuen Dialog zum Festlegen einer JPA-Facette öffnen.

    JPA-Facette hinzufügen

    Das Dialogfeld „JPA-Fakten“ sollte wie in Abbildung 1.3 dargestellt angezeigt werden. In diesem Dialogfeld kann der Benutzer die erforderlichen Bibliotheken hinzufügen, um die JPA zu implementieren.

    JPA-Facette

    Abbildung 1.3

  • Der Dialog zeigt die Plattform der Persistenz an, die verwendet wird; Standardmäßig ist die Option „Generic 2.1“ ausgewählt. Ändern Sie die Plattform in „EclipseLink 2.5.x“.

  • Lassen Sie das JPA-Implementierungsmenü unverändert. Mit dem Typ „Benutzerbibliothek“ können Sie eine benutzergesteuerte Bibliothek hinzufügen. Und fügen Sie die JPA-Bibliothek hinzu.
  • Klicken Sie auf „Bibliotheken verwalten“. Eine andere Möglichkeit zum Hinzufügen einer Bibliothek kann durch die Verwendung von „Bibliothek herunterladen“ erreicht werden, die in diesem Tutorial nicht behandelt wird.
  • Klicken Sie auf „Neu“, um eine neue Bibliothek hinzuzufügen.
  • Legen Sie den Namen der Bibliothek fest und klicken Sie auf „Okay“.
  • Jetzt ist die Bibliothek bereit, die erforderlichen JARs hinzuzufügen, die im Schritt „EclipseLink-JAR-Dateien installieren“ erwähnt wurden. Siehe Abbildung 1.4.

    JPA-Benutzerbibliothek erstellen

    Abbildung 1.4

    Bibliothekskonfiguration

    Die Konfiguration der Bibliothek erfordert das Hinzufügen der erforderlichen JARs-Datei zur Implementierung der JPA. Befolgen Sie die nächsten Schritte, um diese Konfiguration zu erreichen.

    • Klicken Sie auf „Externe JARs hinzufügen“.
    • Fügen Sie eclipselink.jar hinzu, das sich unter „C:/JavaBeat/eclipselink/jlib“ befindet.
    • Fügen Sie jedes JAR hinzu, beginnend mit javax.persistence.*, das sich unter „C:/JavaBeat/eclipselink/jlib/jpa“ befindet. Siehe Abbildung 1.5.

    Add-Bibliotheken

    Abbildung 1.5

    • Klicken Sie auf „Okay“. Das Dialogfeld „Bibliothek hinzufügen“ sollte geschlossen werden. Aber um die JPA-Facette zu vermeiden: „Es muss mindestens eine Benutzerbibliothek ausgewählt werden“.
    • Wählen Sie die erstellte Bibliothek aus.
    • Klicken Sie auf „Okay“.

    Das erstellte dynamische Projekt ist jetzt für die Verwendung einer JPA bereit. Aber die JPA ist ein Persistenzdienst, der sich auf das relationale Datenbanksystem bezieht. Es bleibt also nur noch ein Schritt und es ist die Erstellung der Datenbankverbindung.

    Erstellung einer Datenbankverbindung

    Nachdem Sie die Erstellung einer Benutzerbibliothek abgeschlossen haben, erfolgt nun der Schritt zum Erstellen einer Datenbankverbindung. Der letzte Dialog sollte erscheinen, wie Sie in Abbildung 1.6 sehen können.

    UserLibraryHinzugefügt

    Abbildung 1.6

    Um eine Datenbankverbindung zu erstellen, führen Sie die folgenden Schritte aus:

  • Klicken Sie auf „Verbindung hinzufügen“.
  • Der Dialog „Verbindungsprofil“ wird geöffnet.
  • Wählen Sie den Datenbanktyp aus, den Ihr Projekt verwenden würde. In diesem Tutorial wird davon ausgegangen, dass es sich bei der verwendeten Datenbank um eine MySQL-Datenbank handelt.
  • Ändern Sie den Namen der Verbindung. Weiter klicken.
  • Füllen Sie das Formular „Angeben eines Treibers und Verbindungsdetails“ aus. Der Dialog sollte den Treiber der Datenbank auswählen, die Sie automatisch ausgewählt haben. Ist dies nicht der Fall, müssen Sie eine neue Treiberdefinition installieren. Darauf wird in diesem Artikel nicht eingegangen. Wenn Sie jedoch zu den Eigenschaften der Verbindung gelangen, sollten Sie die korrekten Datenbankverbindungsinformationen angeben und dann auf „Verbindung testen“ klicken. Siehe Abbildung 1.7.
  • Am Ende von Schritt 5 sind Sie bereit, Ihre Verbindung in Ihrem JPA-Projekt zu verwenden.
  • Klicken Sie auf „Fertig stellen“.
  • Der Dialog sollte geschlossen werden. Stellen Sie daher sicher, dass die erstellte Verbindung ausgewählt wurde.
  • Klicken Sie auf „Okay“, um den Dialog „Weitere Konfiguration“ zu schließen.
  • Klicken Sie auf „Okay“, um die Projektaspekte zu schließen.
  • Verbindungstest

    Abbildung 1.7

    Jetzt haben Sie ein neues „Dynamisches Projekt“ erstellt und es für die JPA-Verwendung konfiguriert. Navigieren Sie durch das erstellte Projekt und öffnen Sie die Datei persistence.xml, die sich im Ordner „META-INF“ befindet.

    Persistenzkonfiguration

    Wenn Sie hier angekommen sind, scheint alles erfolgreich abgeschlossen zu sein, also ist es an der Zeit, das zu bearbeiten persistence.xml Das würde uns helfen, unsere Datenbank zu verbinden.

    Um die Datei persistence.xml zu konfigurieren, müssen Sie darauf doppelklicken. Es sollte in einem separaten Editor geöffnet werden. Der geöffnete Editor verfügt über mehrere betitelte Registerkarten, die unten im Editor angezeigt werden. Befolgen Sie die folgenden Schritte für die vollständige Konfiguration von persistence.xml.

  • Navigieren Sie zur Registerkarte „Verbindung“.
  • Ändern Sie den Transaktionstyp in „Resource Local“. Diese Änderung sollte den EclipseLink-Verbindungspool aktivieren.
  • Klicken Sie auf „Von Verbindung ausfüllen“.
  • Wählen Sie die zuvor erstellte Verbindung aus.
  • Verwenden Sie Strg + S, um die Datei zu speichern.
  • Navigieren Sie zur Registerkarte „Quelle“. Sie sollten den minimalen Konfigurationsaufwand sehen, der zum Verbinden Ihrer Datenbank erforderlich ist.
  • Informationen zur korrekten Datenbankverbindung finden Sie in Abbildung 1.8.

    ConnectionWithinPersistence

    Abbildung 1.8

    Testen der EclipseLink-Anwendung

    Um die Konfiguration Ihres Projekts zu testen, ob es funktioniert oder nicht, müssen Sie eine Java-Klasse entwickeln. Diese Java-Klasse sollte den Persistenznamen Ihrer persistence.xml verwenden. In unserem Fall lautet der Persistenzname „EclipseLink-JPA-Installation“.

    • Schreiben Sie eine Hauptmethode und verwenden Sie die Persistence-Klasse, um EntityManagerFactory zu erstellen. Dies gilt als Einstiegspunkt für die JPA.
    • Testen Sie Ihre Verbindung, indem Sie die Methode isOpen() aus dem zuvor erstellten Entitätsmanager aufrufen. Siehe Abbildung 1.9.

    Testergebnis

    Abbildung 1.9

    Der Code der Testanwendung:

    package net.javabeat.eclipselink;
    import javax.persistence.EntityManagerFactory;
    import javax.persistence.Persistence;
    public class JPAImpl {
    public static void main(String [] args){
    EntityManagerFactory factory = Persistence.createEntityManagerFactory("EclipseLink-JPA-Installation");
    System.out.println("Is opened connection :: "+ factory.createEntityManager().isOpen());
    }
    }
    

    Kommentar verfassen

    Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

    Nach oben scrollen