Gestione del file persistence.xml

Quando si crea un progetto, Eclipse crea il file META-INF\persistence.xml nella directory del progetto.

Ô possibile creare un file stub persistence.xml nella directory META-INF quando si crea un progetto JPA (consultare "Creazione di un nuovo progetto JPA"). Ô possibile gestire questo file tramite un editor XML (consultare ) o tramite l'Editor persistence.xml.


Nota:

In base all'implementazione JPA (ad esempio, EclipseLink), potrebbero essere disponibili le seguenti pagine supplementari nell'Editor persistence.xml:
  • Personalizzazione

    Utilizzare questa pagina per definire la traccia delle modifiche e le propriet… correlate al programma di personalizzazione della sessione.

  • Cache

    Utilizzare questa pagina per definire le propriet… della cache.

  • Logging

    Utilizzare questa pagina per definire le propriet… di registrazione log.

  • Opzioni

    Utilizzare questa pagina per definire le propriet… della sessione e del database di destinazione.

  • Generazione dello schema

    Utilizzare questa pagina per definire le propriet… correlate a DDL.

Per progetti che utilizzano l'implementazione JPA EclipseLink, la pagina Connessioni include anche le propriet… del pool di connessioni JDBC.

Se il progetto utilizza la piattaforma generica, sono disponibili solo le pagine Generale, Connessione, Propriet… e Origine.


Per utilizzare l'editor persistence.xml:

  1. Aprire il file peristence.xml. Viene visualizzata la pagina Generale dell'editor.

  2. Utilizzare la pagina Generale per definire gli attributi relativi a <persistent-unit> dei file persistence.xml ed anche gli elementi <provider> e <class> (descritti nella seguente tabella).


    Suggerimento:

    La pagina Origine dell'editor persistence.xml consente di visualizzare e modificare il file XML non elaborato.

    Propriet… Descrizione Elemento definito
    Nome Immettere il nome dell'unit… di persistenza. <persistence-unit name = "<Name>">
    Fornitore di persistenza Immettere il nome del fornitore di persistenza. <provider>
    Descrizione Immettere una descrizione per questa unit… di persistenza. Questa Š una propriet… facoltativa. <description>
    Classi gestite Aggiungere o rimuovere le classi gestite tramite l'unit… di persistenza. <class>
      Escludi classi non elencate Selezionare per includere tutte le classi entit… annotate nella root dell'unit… di persistenza. <exclude-unlisted-classes>
    File di associazione XML Aggiungere o rimuovere i file XML di associazione oggetto/relazionale che definiscono le classi gestite tramite l'unit… di persistenza. <mapping-file>
      File JAR Aggiungere o rimuovere librerie e file JAR aggiuntivi

  3. Utilizzare la pagina Connessione per definire gli elementi <jta-data-source> e <non-jta-data-source> come segue:

    Per configurare l'origine JTA (Java Transaction API) utilizzata dal fornitore di persistenza:

    1. Selezionare JTA dall'elenco Tipo di transazione.

    2. Immettere il nome JNDI globale dell'origine dati.

    Per configurare un'origine dati non JTA:

    1. Selezionare Risorsa locale dall'elenco Tipo di transazione.

    2. Immettere il nome JNDI globale dell'origine dati.


      Nota:

      Selezionare Impostazione predefinita () per utilizzare l'origine dati fornita dal contenitore.

    Per progetti che utilizzano la piattaforma generica, Š possibile definire anche il driver del pool di connessioni EclipseLink, il driver del pool di connessioni, l'URL, il nome utente e la password.

  4. Utilizzare la tabella nella pagina Propriet… per impostare elementi <properties> specifici del fornitore.

    Per aggiungere elementi <property>:

    1. Fare clic su Aggiungi.

    2. Immettere gli attributi <name> e <value> per l'elemento <property> utilizzando i campi Nome e Valore della tabella.

    Per rimuovere un elemento <property>, selezionare una propriet… definita nella tabella e quindi fare clic su Rimuovi.


    Nota:

    Se il progetto utilizza la piattaforma EclipseLink, la pagina di connessione include anche i parametri per il pool delle connessioni JDBC.

Attivit… correlate

Editor persistence.xml

 

Attivit… correlate

Sincronizzazione classi in corso

 

Concetti correlati

Il file persistence.xml