Administrere filen persistence.xml

Nr du oppretter et prosjekt, oppretter Eclipse filen META-INF\persistence.xml i prosjektets katalog.

Du kan opprette en persistence.xml-stubbfil i katalogen META-INF nr du oppretter et JPA-prosjekt (se "Opprette et nytt JPA-prosjekt"). Du kan arbeide med denne filen ved hjelp av XML-redigeringsprogrammet (se ) eller ved hjelp av redigeringsprogrammet for persistence.xml.


Merk:

Avhengig av JPA-implementeringen (for eksempel EclipseLink) vil du ha tilgang til flgende tilleggssider i redigeringsprogrammet for persistence.xml:
  • Tilpasning

    P denne siden kan du definere egenskaper for endringssporing og sesjonstilpasning.

  • Hurtigbufring

    P denne siden kan du definere hurtigbufringsegenskaper.

  • Logging

    P denne siden kan du definere loggingsegenskaper.

  • Alternativer

    P denne siden kan du definere sesjons- og mldatabaseegenskaper.

  • Skjemagenerering

    P denne siden kan du definere DDL-relaterte egenskaper.

For prosjekter som bruker EclipseLink JPA-implementeringen, inneholder siden Tilkobling ogs egenskaper for JDBC-tilkoblingspool.

Hvis prosjektet bruker Generic-plattformen, er bare sidene Generelt, Tilkobling, Egenskaper og Kilde tilgjengelige.


Slik bruker du redigeringsprogrammet for persistence.xml:

  1. pne filen peristence.xml. Siden Generelt i redigeringsprogrammet pnes.

  2. P siden Generelt definerer du persistence.xml-filens <persistent-unit>-relaterte attributter og elementene <provider> og <class> (beskrevet i tabellen nedenfor).


    Tips:

    P siden Kilde i redigeringsprogrammet for persistence.xml kan du vise og redigere XML-rfilen.

    Egenskap Beskrivelse Element definert
    Navn Oppgi navnet p persistensenheten. <persistence-unit name = "<Name>">
    Persistensleverandr Oppgi navnet p persistensleverandren. <provider>
    Beskrivelse Oppgi en beskrivelse for denne persistensenheten. Dette er en valgfri egenskap. <description>
    Styrte klasser Legg til eller fjern klasser som styres gjennom denne persistensenheten. <class>
      Ekskluder klasser som ikke er p listen Velg om du vil inkludere alle annoterte entitetsklasser i roten av persistensenheten. <exclude-unlisted-classes>
    XML-tilordningsfiler Legg til eller fjern XML-filene for objekt-/relasjonstilordning som definerer klassene som styres gjennom denne persistensenheten. <mapping-file>
    JAR-filer Legg til eller fjern ekstra JAR-filer og -biblioteker

  3. P siden Tilkobling definerer du elementene <jta-data-source> og <non-jta-data-source> slik:

    Slik konfigurerer du JTA-kilden (JTA=Java Transaction API) som brukes av persistensleverandren:

    1. Velg JTA fra listen Transaksjonstype.

    2. Oppgi det globale JNDI-navnet for datakilden.

    Slik konfigurerer du en ikke-JTA-datakilde:

    1. Velg Lokal ressurs fra listen Transaksjonstype.

    2. Oppgi det globale JNDI-navnet for datakilden.


      Merk:

      Velg Default() hvis du vil bruke datakilden fra containeren.

    For prosjekter som bruker Generic-plattformen, kan du ogs definere driveren for tilkoblingspoolen til EclipseLink samt driveren, URL-adressen, brukernavnet og passordet for tilkoblingspoolen.

  4. Bruk tabellen p siden Egenskaper nr du skal definere det leverandspesifikke <properties>-elementet.

    Slik legger du til <property>-elementer:

    1. Klikk p Legg til.

    2. Oppgi attributtene <name> og <value> for <property>-elementet ved hjelp av tabellens navn- og verdifelt.

    Nr du skal fjerne et <property>-element, velger du en definert egenskap i tabellen og klikker p Fjern.


    Merk:

    Hvis prosjektet bruker EclipseLink-plattformen, inneholder tilkoblingssiden ogs parametere for JDBC-tilkoblingspooling.

Beslektet referanse

Redigeringsprogram for persistence.xml

 

Beslektet oppgave

Synkronisere klasser

 

Beslektet begrep

Filen persistence.xml