Créer un projet JPA
Vous pouvez utiliser l'assistant Projet JPA pour créer et configurer un projet JPA.
Pourquoi et quand exécuter cette tâche
Procédure
- Dans la perspective JPA, cliquez sur Fichier > Nouveau > Projet > Projet JPA.
- Dans la zone Nom du projet, tapez un nom pour votre nouveau projet.
- Pour changer l'emplacement par défaut du projet, décochez la case Utiliser la valeur par défaut sous Contenu du projet et cliquez sur Parcourir pour sélectionner le nouvel emplacement.
- Dans la liste Environnement d'exécution cible, sélectionnez l'environnement cible du projet. Cette zone est désactivée si vous avez déjà créé un projet et défini un environnement d'exécution cible.
- Sélectionnez la version JPA à utiliser dans le projet.
- Dans Configurations, sélectionnez Configuration
- Optionnel : pour ajouter le nouveau projet à un fichier d'application
d'entreprise (EAR), cochez
la case Ajouter un module à une application EAR. Tapez un nouveau nom de projet ou sélectionnez un projet EAR existant
dans la liste Nom du projet EAR. Ou encore, cliquez sur Nouveau pour
démarrer l'assistant Nouveau projet d'application EAR. Remarque : Si vous entrez un nouveau nom de projet EAR, celui-ci est créé à l'emplacement par défaut, avec le numéro de version J2EE le plus bas compatible avec la version du projet créé. Si vous voulez spécifier une autre version ou un autre emplacement pour l'application d'entreprise, vous devez utiliser l'assistant Nouveau projet d'application d'entreprise.
- Cliquez sur Next.
- Facultatif : sélectionnez les dossiers dans le chemin d'accès de génération ou ajoutez-en d'autres en cliquant sur Ajouter un dossier, définissez le dossier de sortie par défaut ou conservez le dossier par défaut. Cliquez sur Suivant.
- Dans la page Facette JPA, suivez la procédure ci-dessous :
- Sélectionnez la plateforme appropriée.
- Sélectionnez le type Bibliothèque fournie par l'exécution cible dans l'implémentation JPA.
- Sélectionnez la connexion de base de données appropriée pour ce projet ou cliquez
sur Ajouter une connexion pour en créer une nouvelle. Remarque : Pour pouvoir mapper des entités aux tables d'une base de données ou pour générer des entités JPA à partir d'une base de données existante, vous devez disposer d'une connexion active à la base de données concernée.
- Pour la gestion des classes persistantes, indiquez si les classes annotées doivent être découvertes automatiquement par l'environnement d'exécution ou si elles doivent être listées dans le fichier persistence.xml.
- Si vous voulez que le fichier orm.xml soit créé automatiquement, sélectionnez Créer orm.xml. Le fichier orm.xml peut être utilisé pour remplacer les détails des mappages objet-relationnel spécifiés dans les classes Java™ via les annotations JPA.
Le fichier orm.xml se trouve dans le répertoire META-INF du projet. Avertissement : WebSphere Application Server Traditional V9 prend en charge JPA 2.0 et JPA 2.1. La version de JPA que vous utilisez dans votre projet doit correspondre à la version de JPA employée dans votre installation WebSphere Application Server Traditional V9. Si ces versions ne correspondent pas, les outils affichent un avertissement lors du déploiement du projet sur le serveur.Lorsque vous créez un projet JPA 2.0, les outils ajoutent les fichiers suivants au conteneur du chemin d'accès aux classes :
com.ibm.ws.jpa.jar com.ibm.ws.jpa.container20.jar javax.j2ee.persistence.2.0.jarLorsque vous créez un projet JPA 2.1, les outils ajoutent les fichiers suivants au conteneur du chemin d'accès aux classes :com.ibm.ws.jpa.eclipselink.jar com.ibm.ws.jpa.container21.jar javax.j2ee.persistence.jar
- Cliquez sur Terminer.
Rubrique parent : Développement d'applications Java Persistence API (JPA)