Tiedoston persistence.xml hallinta

Projektia luotaessa Eclipse luo projektin hakemistoon META-INF\persistence.xml-tiedoston.

META-INF-hakemistoon voi luoda persistence.xml-tiedoston tukirakenteen JPA-projektia luotaessa (katso lis„tietoja kohdasta "Uuden JPA-projektin luonti"). T„t„ tiedostoa voi hallita joko XML-muokkausohjelman (katso ) tai persistence.xml-muokkausohjelman avulla.


Huomautus:

Persistence.xml-muokkausohjelmassa voi olla k„ytett„viss„ seuraavanlaisia lis„sivuja sen mukaan, millainen JPA-toteutus on (esimerkiksi EclipseLink):
  • Mukautus

    T„ll„ sivulla voit m„„ritt„„ muutosten j„ljitykseen ja istunnon mukautustoimintoon liittyvi„ ominaisuuksia.

  • Tallennus v„limuistiin

    T„ll„ sivulla voit m„„ritt„„ v„limuistiin tallennuksen ominaisuuksia.

  • Kirjaus

    T„ll„ sivulla voit m„„ritt„„ kirjauksen ominaisuuksia.

  • Asetukset

    T„ll„ sivulla voit m„„ritt„„ istunnon ja kohdetietokannan ominaisuuksia.

  • Skeeman luonti

    T„ll„ sivulla voit m„„ritt„„ DDL-tiedostoon liittyvi„ ominaisuuksia.

EclipseLink-k„ytt”ymp„rist”n JPA-toteutusta k„ytt„vi„ projekteja varten Yhteydet-sivulla on my”s JDBC-yhteysvarannon ominaisuudet.

Jos projekti k„ytt„„ Yleinen-k„ytt”ymp„rist”„, vain Yleiset-, Yhteys-, Ominaisuudet- ja L„hde-sivut ovat k„ytett„viss„.


persistence.xml-muokkausohjelmaa k„ytet„„n seuraavasti:

  1. Avaa persistence.xml-tiedosto. Muokkausohjelman Yleiset-sivu avautuu.

  2. K„yt„ Yleiset-sivua m„„ritt„ess„si persistence.xml-tiedoston <persistent-unit>-yksikk””n liittyvi„ m„„ritteit„ sek„ <provider>- ja <class>-elementtej„ (jotka on kuvattu seuraavassa taulukossa).


    Vihje:

    persistence.xml-muokkausohjelman L„hde-sivun avulla voit tarkastella ja muokata muotoilematonta XML-tiedostoa.

    Ominaisuus Kuvaus Elementin m„„ritt„m„
    Nimi Anna pysyvyysyksik”n nimi. <persistence-unit name = "<Name>">
    Pysyvyystoimittaja Anna pysyvyystoimittajan nimi. <provider>
    Kuvaus Kirjoita t„m„n pysyvyysyksik”n kuvaus. T„m„ ominaisuus on valinnainen. <description>
    Ohjatut luokat Lis„„ tai poista pysyvyysyksik”n kautta ohjattuja luokkia. <class>
      Ohita luokat, joita ei ole luettelossa Valitsemalla t„m„n voit sis„llytt„„ kaikki pysyvyysyksik”n juurihakemistossa olevat, huomautuksia sis„lt„v„t olioluokat. <exclude-unlisted-classes>
    XML-vastaavuustiedostot   Lis„„ tai poista objektin/suhteiden vastaavuusm„„rityksi„. XML-tiedostot m„„ritt„v„t pysyvyysyksik”n kautta ohjattuja luokkia. <mapping-file>
    JAR-tiedostot Lis„„ tai poista JAR-lis„tiedostoja ja -kirjastoja

  3. K„yt„ Yhteys-sivua seuraavalla tavalla m„„ritt„ess„si <jta-data-source>- ja <non-jta-data-source>-elementtej„:

    Pysyvyystoimittajan k„ytt„m„ JTA (Java Transaction API) -l„hde m„„ritet„„n seuraavalla tavalla:

    1. Valitse JTA Tapahtumalaji-luettelosta.

    2. Anna tietol„hteen yleinen JNDI-nimi.

    Muu kuin JTA-tietol„hde m„„ritet„„n seuraavalla tavalla:

    1. Valitse Paikallisresurssi Tapahtumalaji-luettelosta.

    2. Anna tietol„hteen yleinen JNDI-nimi.


      Huomautus:

      Valitse Oletusarvo(), kun haluat k„ytt„„ s„il”n tietol„hdett„.

    Jos projekti k„ytt„„ Yleinen-k„ytt”ymp„rist”„, voit m„„ritt„„ my”s EclipseLink-yhteysvarannon ajurin, URL-osoitteen, k„ytt„j„tunnuksen ja salasanan.

  4. K„yt„ Ominaisuudet-sivun taulukkoa, kun haluat m„„ritt„„ toimittajakohtaisen <properties>-elementin.

    Voit lis„t„ <property>-elementtej„ seuraavasti:

    1. Napsauta Lis„„-painiketta.

    2. Anna <property>-elementille <name>- ja <value>-m„„ritteet taulukon Nimi- ja Arvo-kenttien avulla.

    Voit poistaa <property>-elementin valitsemalla ensin taulukosta m„„ritetyn ominaisuuden ja napsauttamalla sitten Poista-painiketta.


    Huomautus:

    Jos projekti k„ytt„„ EclipseLink-k„ytt”ymp„rist”„, yhteyssivulla on parametrit my”s JDBC-yhteysvarannon m„„ritt„mist„ varten.

Aiheeseen liittyvi„ ohjeita

persistence.xml-muokkausohjelma

 

Aiheeseen liittyv„ teht„v„

Luokkien synkronointi

 

Aiheeseen liittyv„ k„site

Tiedosto persistence.xml