Hantera filen persistence.xml

När du skapar ett projekt, skapar Eclipse filen META-INF\persistence.xml i projektets katalog.

Du kan skapa persistence.xml-fil med kodstycke i META-INF-katalogen när du skapar ett JPA-projekt (se "Skapa ett nytt JPA-projekt). Du kan arbeta med filen i XML-redigeraren eller med redigeraren persistence.xml.


Anm.

Beroende på JPA-implementationen (t.ex. EclipseLink) kan följande sidor vara tillgängliga i redigeraren persistence.xml:
  • Anpassning

    På sidan definierar du egenskaper som är relaterade till spårningsändringar och sessionsanpassning.

  • Cachning

    På sidan definierar du cachningsegenskaper

  • Loggning

    På sidan definierar du loggningsegenskaper.

  • Alternativ

    På sidan definierar du sessions- och måldatabasegenskaper

  • Schemagenerering

    På sidan definierar du DDL-relaterade egenskaper

För projekt som använder JPA-plattformen för EclipseLink innehåller sidan Anslutningar också egenskaper för JDBC-anslutningspool.

Om projektet använder den allmänna plattformen är endast sidorna Allmänt, Anslutning, Egenskaper och Källa tillgängliga.


Så här använder du redigeraren persistence.xml:

  1. Öppna filen peristence.xml. Sidan Allmänt öppnas i redigeraren.

  2. På sidan Allmänt definierar du persistence.xml-filernas <persistent-unit>-relaterade attribut samt <provider>- och <class>-element (beskrivs i följande tabell).


    Tips!

    På källsidan för redigeraren persistence.xml kan du visa och redigera den råa XML-filen.

    Egenskap Beskrivning Definierade element
    Namn Ange namnet på den beständiga enheten. <persistence-unit name = "<Name>">
    Beständighetsleverantör Ange beständighetsleverantörens namn. <provider>
    Beskrivning Ange en beskrivning för den här beständighetsenheten. Egenskapen är valfri. <description>
    Hanterade klasser Lägg till eller ta bort klasserna som hanteras via beständighetsenheten. <class>
      Exkludera ej angivna klasser Välj alternativet för att inkludera alla kommenterade entitetsklasser i roten för beständighetsenheten. <exclude-unlisted-classes>
    XML -avbildningsfiler  Lägg till eller ta bort XML-filerna med objekt-/relationsavbildningar som definierar klasserna som hanteras via beständighetsenheten. <mapping-file>
    JAR-filer Lägg till eller ta bort ytterligare JAR-filer och bibliotek

  3. Använd sidan Anslutning för att definiera <jta-data-source>- och <non-jta-data-source>-elementen enligt följande:

    Så här konfigurerar du den JTA-källa (Java Transaction API) som används av beständighetsleverantören:

    1. Välj JTA i listan Transaktionstyp

    2. Ange datakällans globala JNDI-namn.

    Så här konfigurerar du en icke-JTA-datakälla:

    1. Välj Resurslokal i listan Transaktionstyp.

    2. Ange datakällans globala JNDI-namn.


      Anm.

      Välj Standard () för att använda datakällan som behållaren tillhandahåller.

    För projekt som använder den allmänna plattformen kan du även definiera anslutningspooldrivrutin för EclipseLink, anslutningspooldrivrutin, URL-adress, användarnamn och lösenord.

  4. Använda tabellen på sidan Egenskaper för att ange det leverantörsspecifika <properties>-elementet.

    Så här lägger du till <property>-element:

    1. Klicka på Lägg till.

    2. Ange <name>- och <value>-attributen för <property>-elementet i tabellens namn- och värdefält.

    Du tar bort ett <property>-element genom att välja en definierad egenskap i tabellen och sedan klicka på Ta bort.


    Anm.

    Om projektet använder EclipseLink-plattformen innehåller anslutningssidan också parametrar för JDBC-anslutningspooler.

Närliggande referens

Redigeraren persistence.xml

 

Närliggande uppgifter

Synkronisera klasser

 

Närliggande begrepp

Filen persistence.xml