Vous pouvez utiliser l'assistant Projet JPA pour créer et configurer un projet JPA.
Pourquoi et quand exécuter cette tâche
Pour créer un projet JPA :
Procédure
- Dans la perspective JPA, cliquez sur .
- 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.
- Cliquez sur Terminer.