Administrér filen persistence.xml

Når du opretter et projekt, opretter Eclipse filen META-INF\persistence.xml i projektets bibliotek.

Du kan oprette en persistence.xml-stubfil i biblioteket META-INF, når du opretter et JPA-projekt (se "Opret et nyt JPA-projekt"). Du kan administrere filen via XML-editoren eller via editoren til persistence.xml.


Bemærk:

Afhængig af din JPA-implementering (f.eks. EclipseLink) kan følgende yderligere sider være tilgængelige i editoren til persistence.xml:

  • Tilpasning

    Brug siden til at definere egenskaber i forbindelse med ændringssporing og sessionstilpasning.

  • Caching

    Brug siden til at definere egenskaber for caching.

  • Logning

    Brug siden til at definere egenskaber for logning.

  • Tilpasning

    Brug siden til at definere egenskaber for session og måldatabase.

  • Skemagenerering

    Brug siden til at definere DDL-relaterede egenskaber.

For projekter, der bruger EclipseLink JPA-implementeringen, indeholder siden Forbindelser også egenskaber for JDBC-forbindelsespuljen.

Hvis projektet bruger den generiske platform, er kun siderne Generelt, Forbindelse, Egenskaber og Kilde tilgængelige.

Sådan bruges editoren til persistence.xml:

  1. Åbn filen persistence.xml. Siden Generelt i editoren vises.

  2. Brug siden Generelt til at definere <persistent-unit>-relaterede attributter i persistence.xml-filer samt <provider>- og <class>-elementer (beskrives i følgende tabel).


    Tip:

    På siden Kilde i editoren til persistence.xml kan du se og redigere den ubehandlede XML-fil.

    Egenskab Beskrivelse Element defineret
    Navn Angiv navnet på persistensenheden. <persistence-unit name = "<Navn>">
    Persistence-udbyder Angiv navnet på persistensudbyderen. <provider>
    Beskrivelse Angiv en beskrivelse af persistensenheden. Egenskaben er valgfri. <beskrivelse>
    Administrerede klasser Tilføj eller fjern klasser, der administreres via persistensenheden. <class>
      Udelad ikke viste klasser   Vælges for at inkludere alle annoterede klasser i roden af persistensenheden. <exclude-unlisted-classes>
    XML-mappingfiler   Tilføj eller fjern de objekt-relationelle XML-mapping-filer, som definerer de klasser, der administreres via persistensenheden. <mapping-file>
    JAR-filer  Tilføj eller fjern yderligere JAR-filer og biblioteker

  3. Brug siden Forbindelse til at definere elementerne <jta-data-source> og <non-jta-data-source> på følgende måde:

    Sådan konfigureres den JTA-kilde (Java Transaction API), der bruges af persistence-udbyderen:

    1. Vælg JTA på listen Transaktionstype.

    2. Angiv datakildens globale JNDI-navn.

    Sådan konfigureres en ikke-JTA-datakilde:

    1. Vælg Ressourcelokal på listen Transaktionstype.

    2. Angiv datakildens globale JNDI-navn.


      Bemærk:

      Vælg Standard () for at bruge den datakilde, som opbevaringsstedet leverer.

    For projekter, der bruger den generiske platform, kan du også definere styreprogram til EclipseLink-forbindelspuljen, URL, brugernavn og kodeord.

  4. Brug tabellen på siden Egenskaber til at angive det leverandørspecifikke element <property>.

    Sådan tilføjes <property>-elementer:

    1. Klik på Tilføj.

    2. Angiv attributterne <name> og <value> for elementet <property> i felterne Navn og Værdi i tabellen.

    Du kan fjerne et <property>-element ved at vælge en defineret egenskab i tabellen og derefter klikke på Fjern.


    Bemærk:

    Hvis projektet bruger EclipseLink-platformen, indeholder siden Forbindelse også parametre for JDBC-forbindelsespuljen.

Relaterede referencer

Editoren til persistence.xml

 

Relateret opgave

Synkronisér klasser

 

Relateret begreb

Filen persistence.xml