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 :
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
:
Ouvrez le fichier peristence.xml
. La page Général de l'éditeur s'affiche.
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. |
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 :
Sélectionnez JTA dans la liste Type de transaction.
Entrez le nom JNDI global de la source de données.
Pour configurer une source de données non-JTA, procédez comme suit :
Sélectionnez Ressource - locale dans la liste Type de transaction.
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.
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>
:
Cliquez sur Ajouter.
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. |