Gestion du fichier persistence.xml

Lorsque vous créez un projet, Eclipse crée le fichier META-INF\persistence.xml dans le répertoire du projet.

Lors de la création d'un projet JPA (voir Création d'un projet JPA), vous pouvez aussi créer un fichier persistence.xml de remplacement dans le répertoire META-INF. Vous pouvez gérer ce fichier soit à l'aide de l'éditeur XML soit à l'aide de l'éditeur persistence.xml.


Remarque :

Selon votre implémentation JPA (Générique, par exemple), les page supplémentaires suivantes peuvent être disponibles dans l'éditeur persistence.xml :
  • Personnalisation

    Cette page permet de définir les propriétés relatives au suivi des modifications et au personnaliseur de session.

  • Mise en cache

    Utilisez cette page pour définir les propriétés de mise en cache.

  • Consignation

    Utilisez cette page pour définir les propriétés de consignation.

  • Options

    Utilisez cette page pour définir les propriétés de session et de base de données cible.

  • Génération de schéma

    Utilisez cette page pour définir les propriétés relatives à DDL (langage de définition de données).

Pour les projets qui utilisent l'implémentation JPA EclipseLink, la page Connexions contient également les propriétés du pool de connexions JDBC.

Si le projet utilise la plateforme générique, seules les pages Général, Connexion, Propriétés et Source sont disponibles.


Pour utiliser l'éditeur persistence.xml :

  1. Ouvrez le fichier peristence.xml. La page Général de l'éditeur s'affiche.

  2. Utilisez la page Général pour définir les attributsd'<unité de persistance> des fichiers persistence.xml, ainsi que les éléments <fournisseur> et <classe> (décrits dans le tableau suivant).


    Conseil :

    La page Source de l'éditeur persistence.xml vous permet d'afficher et de modifier le fichier XML brut.

    Propriété Description Elément défini
    Nom Entrez le nom de l'unité de persistance. <persistence-unit name = "<Name>">
    Fournisseur de persistance Entrez le nom du fournisseur de persistance. <provider>
    Description Entrez une description pour cette unité de persistance. Cette propriété est facultative. <description>
    Classes gérées Ajoutez ou supprimez les classes gérées via l'unité de persistance. <class>
      Exclure les classes absentes de la liste Sélectionnez cette propriété pour inclure toutes les classes entité annotées à la racine de l'unité de persistance. <exclude-unlisted-classes>
    Fichiers de mappage XML Ajoutez ou supprimez les fichiers XML de mappage relationnel/d'objets qui définissent les classes gérées via l'unité de persistance. <mapping-file>
    Fichiers JAR Ajouter ou supprimer des bibliothèques et des fichiers JAR

  3. La page Connexion vous permet de définir les éléments <jta-data-source> et <non-jta-data-source> de la façon suivante :

    Pour configurer la source JTA (Java Transaction API) utilisée par le fournisseur de persistance, procédez comme suit :

    1. Sélectionnez JTA dans la liste Type de transaction.

    2. Entrez le nom JNDI global de la source de données.

    Pour configurer une source de données non-JTA, procédez comme suit :

    1. Sélectionnez Ressource - locale dans la liste Type de transaction.

    2. Entrez le nom JNDI global de la source de données.


      Remarque :

      Sélectionnez Default() si vous voulez utiliser la source de données fournie par le conteneur.

    Pour les projets qui utilisent la plateforme générique, vous pouvez définir le pilote de pool de connexions EclipseLink, le pilote de pool de connexions, l'URL, le nom d'utilisateur et le mot de passe.

  4. Utilisez la table figurant dans la page Propriétés pour définir l'élément <properties> propre au fournisseur.

    Pour ajouter les éléments <property> :

    1. Cliquez sur Ajouter.

    2. Entrez les attributs <name> et <value> pour l'élément <property> à l'aide des zones Nom et Valeur de la table.

    Pour supprimer un élément <property>, sélectionnez une propriété définie dans la table, puis cliquez sur Supprimer.


    Remarque :

    Si le projet utilise la plateforme EclipseLink, la page Connexion contient également des paramètres pour le regroupement de connexions JDBC.

Référence connexe

Editeur persistence.xml

 

Tâche connexe

Synchronisation des classes

 

Concept connexe

Le fichier persistence.xml