Datei 'persistence.xml' verwalten

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

Beispieldatei 'persistence.xml'

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd">
     <persistence-unit name="QuickStart">
          <class>quickstart.demo.model.Address</class>
          <class>quickstart.demo.model.Item</class>
     </persistence-unit>
</persistence>

Sie können diese Datei entweder über den XML-Editor oder über den Editor für 'persistence.xml' verwalten.

Editor für 'persistence.xml'

Registerkarte 'Allgemein' im Editor für 'persistence.xml'

Hinweis:

In Abhängigkeit von der verwendeten JPA-Implementierung (beispielsweise EclipseLink) können im Editor für 'persistence.xml' folgende Seiten verfügbar sein:

  • Allgemein – Verwenden Sie diese Seite, um die Klassen, Zuordnungsdateien und JAR-Dateien für die Permanenzeinheit zu definieren.

  • Verbindung – Verwenden Sie diese Seite, um die Datenquelle (JTA- oder Nicht-JTA-Elemente) für das Projekt zu definieren.

  • Anpassung – Verwenden Sie diese Seite, um Eigenschaften für die Änderungsverfolgung und Sitzungsanpassungsfunktionen zu definieren.

  • Caching – Verwenden Sie diese Seite, um Eigenschaften für das Caching zu definieren.

  • Protokollierung – Verwenden Sie diese Seite, um Eigenschaften für die Protokollierung zu definieren.

  • Optionen – Verwenden Sie diese Seite, um Eigenschaften für Sitzungen und Zieldatenbanken zu definieren.

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

  • Eigenschaften – Verwenden Sie diese Seite, um herstellerspezifische Eigenschaften hinzuzufügen oder zu entfernen.

  • Quelle – Verwenden Sie diese Seite, um die XML-Quelle der Datei persistence.xml anzuzeigen oder zu ändern.

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.

Um den Editor für 'persistence.xml' zu verwenden, gehen Sie wie folgt vor:

  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.

    Registerkarte 'Allgemein' im Editor für 'persistence.xml'

    Registerkarte 'Allgemein' im Editor für 'persistence.xml'

  3. Füllen Sie jedes Feld auf der Seite Allgemein aus.

  4. 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.

    Registerkarte 'Verbindung' im Editor für 'persistence.xml'

    Registerkarte 'Verbindung' im Editor für 'persistence.xml'

  5. Füllen Sie jedes Feld auf der Seite Verbindung aus.

  6. 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 Element vom Typ <property> (Eigenschaft) 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.

    Registerkarte 'Anpassung' im Editor für 'persistence.xml'

    Registerkarte 'Anpassung' im Editor für 'persistence.xml'

  7. Füllen Sie jedes Feld auf der Seite Anpassung aus.

In Abhängigkeit vom verwendeten JPA-Provider können im Editor für 'persistence.xml' zusätzliche Seiten verfügbar sein. Weitere Informationen hierzu finden Sie unter Editor für 'persistence.xml'.

Zugehörige Referenzinformationen

Zugehörige Tasks

Zugehörige Konzepte