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.

Exemple de fichier persistence.xml

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd">
     <persistence-unit name="QuickStart">
          <class>quickstart.demo.model.Address</class>
          <class>quickstart.demo.model.Item</class>
     </persistence-unit>
</persistence>

Vous pouvez gérer ce fichier à l'aide de l'éditeur XML ou de l'éditeur persistence.xml.

L'éditeur persistence.xml

Onglet Général de l'éditeur persistence.xml

Remarque :

Selon votre implémentation JPA (par exemple EclipseLink), les pages suivantes peuvent être disponibles dans l'éditeur persistence.xml :

  • Général – Utilisez cette page pour définir les classes, les fichiers de mappage et les fichiers JAR pour l'unité de persistance.

  • Connexion – Utilisez cette page pour définir la source de données (éléments JTA et non JTA) pour le projet.

  • Personnalisation – Utilisez cette page pour 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 base de données cible et de session.

  • Génération de schéma – Utilisez cette page pour définir les propriétés relatives à DDL.

  • Propriétés – Utilisez cette page pour ajouter ou retirer des propriétés propres au fournisseur.

  • Source – Utilisez cette page pour afficher ou modifier la source XML du fichier persistence.xml.

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 persistence.xml. La page Général de l'éditeur s'affiche.

  2. Utilisez la page Général pour définir les attributs d'<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.

    Onglet Général de l'éditeur persistence.xml

    Onglet Général de l'éditeur persistence.xml

  3. Renseignez chaque zone de la page Général.

  4. 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.

    Onglet Connexion de l'éditeur persistence.xml

    Onglet Connexion de l'éditeur persistence.xml

  5. Renseignez chaque zone de la page Connexion.

  6. 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.

    Onglet Personnalisation de l'éditeur persistence.xml

    Onglet Personnalisation de l'éditeur persistence.xml

  7. Renseignez chaque zone de la page Personnalisation.

D'autres pages peuvent être disponibles pour l'éditeur persistence.xml, selon votre fournisseur JPA. Voir "Editeur persistence.xml" pour plus d'informations.

Référence connexe

Tâches connexes

Concepts connexes