Datei 'persistence.xml' verwalten

Beim Erstellen eines Projekts erstellt Eclipse die Datei META-INF\persistence.xml im Verzeichnis des Projekts.

Sie können eine Stub-persistence.xml-Datei im Verzeichnis META-INF erstellen, wenn Sie ein JPA-Projekt erstellen (weiter Informationen finden Sie im Abschnitt Neues JPA-Projekt erstellen). Sie können diese Dateien entweder über den XML-Editor oder über den Editor 'persistence.xml' verwalten.


Hinweis:

Abhängig von Ihrer JPA-Implementierung (zum Beispiel EclipseLink) sind möglicherweise die folgenden zusätzlichen Seiten im Editor 'persistence.xml' verfügbar:
  • Anpassung

    Verwenden Sie diese Seite, um die Verfolgung von Änderungen und benutzerdefinierte Eigenschaften für Sitzungen zu definieren.

  • Caching

    Verwenden Sie diese Seite, um die Eigenschaften für Caching zu definieren.

  • Protokollieren

    Verwenden Sie diese Seite, um die Protokollierungseigenschaften zu definieren.

  • Optionen

    Verwenden Sie diese Seite, um die Eigenschaften für Sitzungen und die Zieldatenbank zu definieren.

  • Schemagenerierung

    Verwenden Sie diese Seite, um DDL-bezogene Eigenschaften zu definieren.

Für Projekte, die die EclipseLink-JPA-Implementierung verwenden, enthält die Seite 'Verbindungen' auch die Eigenschaften des JDBC-Verbindungspools.

Wenn das Projekt die generischen Plattform verwendet, sind nur die Seiten Allgemein, Verbindung, Eigenschaften und Quelle verfügbar.


Gehen Sie wie folgt vor, um den Editor persistence.xml zu verwenden:

  1. Öffnen Sie die Datei persistence.xml. Die Seite Allgemeines des Editors wird geöffnet.

  2. Verwenden Sie die Seite Allgemein, um die auf <persistent-unit> bezogenen Attribute sowie die Elemente <provider>, und <class> (die in der folgende Tabelle beschrieben werden), für Dateien persistence.xml zu definieren.


    Tipp:

    Die Quellenseite des Editors 'persistence.xml' ermöglicht Ihnen die Ansicht und Bearbeitung der unformatierten XML-Datei.

    Eigenschaft Beschreibung Definiertes Element
    Name Geben Sie den Namen der Permanenzeinheit ein. <Name der Permanenzeinheit = "<Name>">
    Permanenzprovider Geben Sie den Namen des Persistenz-Providers an. <provider>
    Beschreibung Geben Sie eine Beschreibung für diese Permanenzeinheit ein. Diese Eigenschaft ist optional. <Beschreibung>
    Verwaltete Klassen Fügen Sie über die Permanenzeinheit verwaltete Klassen hinzu oder entfernen sie diese. <Klasses>
      Nicht gelistete Klassen ausschließen Wählen Sie diese Option aus, um alle annotierten Entitätsklassen in das Stammverzeichnis der Permanenzeinheit aufzunehmen. <nicht gelistete Klassen ausschließen>
    XML-Zuordnungsdateien   Fügen Sie Objekt-/relationale XML-Zuordnungsdateien zur Definition verwalteter Klassen über die Permanenzeinheit hinzu oder entfernen sie. <zuordnungsdatei>
    JAR-Dateien Fügen Sie zusätzliche JAR-Dateien und -Bibliotheken hinzu oder entfernen Sie solche.

  3. Verwenden Sie die Seite Verbindung, um die <jta-datenquelle> und <nicht-jta-datenquelle> wie folgt zu definieren:

    Gehen Sie wie folgt vor, um die von dem Persistenz-Provider verwendete JTA (Java Transaction API)-Quelle zu konfigurieren:

    1. Wählen Sie JTA aus der Liste der Transaktionstypen aus.

    2. Geben Sie den globalen JNDI-Namen der Datenquelle ein.

    Gehen Sie wie folgt vor, um eine Nicht-JTA-Datenquelle zu konfigurieren:

    1. Wählen Sie Resource Local aus der Liste der Transaktionstypen aus.

    2. Geben Sie den globalen JNDI-Namen der Datenquelle ein.


      Hinweis:

      Wählen Sie Standardwert () aus, um die von dem Container bereitgestellte Datenquelle zu verwenden.

    Bei Projekten, die die generische Plattform verwenden, können Sie auch den EclipseLink-Verbindungspooltreiber sowie URL, Benutzername und Kennwort definieren.

  4. Verwenden Sie die Tabelle auf der Seite 'Eigenschaften', um das herstellerspezifische <Eigenschaften>-Element festzulegen.

    So fügen Sie <Eigenschaften>-Elemente hinzu:

    1. Klicken Sie auf Hinzufügen.

    2. Geben Sie in die Felder 'Name' und 'Wert' der Tabelle die Attribute <Name> und <Wert> für das Element <Eigenschaft> ein.

    Um ein <Eigenschaften>element zu entfernen, wählen Sie eine definierte Eigenschaft in der Tabelle aus und klicken Sie anschließend auf Entfernen.


    Hinweis:

    Wenn das Projekt die EclipseLink-Plattform verwendet, umfasst die Seite 'Verbindung' auch Parameter für JDBC-Verbindungspooling.

Zugehörige Referenzinformationen

Editor 'persistence.xml'

 

Zugehörige Task

Synchronisieren von Klassen

 

Zugehöriges Konzept

Die Datei 'persistence.xml'