Conversion de projets existants pour Maven

Vous pouvez convertir des projets Java™ EE existants pour Maven.

Avant de commencer

Sauvegardez votre espace de travail pour pouvoir restaurer l'état d'origine des projets si nécessaire.

Pourquoi et quand exécuter cette tâche

Il est recommandé d'effectuer les tâches de conversion des projets dans l'ordre suivant :

  1. Définissez les préférences recommandées.
  2. Convertissez les projets autres que les projets EAR.
  3. Convertissez les projets EAR.
    1. Créez un dossier de contenu.
    2. Convertissez le projet EAR.
    3. Ajoutez des modules à un projet EAR.
    4. Ajoutez des dépendances à d'autres modules.
    5. Ajoutez des bibliothèques au répertoire de bibliothèques EAR.

Définition des préférences recommandées

Pourquoi et quand exécuter cette tâche

Afin d'utiliser votre espace de travail pour les projets Maven, définissez d'abord les préférences recommandées.

Procédure

  1. Accédez aux préférences des paramètres de projet Maven. Cliquez sur Fenêtre > Préférences > Java EE > Maven > Paramètres de projet Maven.
  2. Cliquez sur Appliquer toutes les valeurs Maven. Les préférences qui représentent les meilleures pratiques pour la configuration Maven sont définies.
  3. Cliquez sur OK pour terminer la définition des préférences.

Conversion de projets Web, EJB, de connecteur, de client d'application, d'utilitaire, de fragment Web et de client EJB

Pourquoi et quand exécuter cette tâche

Lorsque vous convertissez un projet, gardez à l'esprit les dépendances à d'autres artefacts et la façon dont le projet accède aux artefacts. Dans les projets autres que les projets Maven, ces informations sont spécifiées dans les métadonnées de projet et dans les fichiers MANIFEST.MF directement. Par contre, dans les projets Maven, les dépendances sont spécifiées dans le fichier pom.xml. Par exemple, les artefacts sont accessibles via le fichier MANIFEST.MF ou déployés dans le répertoire de bibliothèques du projet EAR contenant le projet. Pour les projets Web, les artefacts peuvent être déployés dans le répertoire WEB-INF/lib.

D'abord, utilisez la page de l'assemblage de déploiement pour regrouper les informations sur les dépendances.
  1. Cliquez avec le bouton droit de la souris sur le projet.
  2. Sélectionnez Propriétés > Assemblage de déploiement.
  3. Cliquez sur l'onglet Entrées de manifeste. Notez toutes les entrées qui sont référencées par le projet.
  4. Pour les projets Web, cliquez également sur l'onglet Assemblage de déploiement. Notez tous les projets et fichiers JAR dont le chemin de déploiement commence par WEB-INF/lib.
Remarque : Si le projet EAR contenant vos projets possède la facette EAR version 5 ou 6, votre projet peut référencer des classes provenant de projets ou de fichiers JAR qui se trouvent dans le répertoire de bibliothèques du fichier EAR. Notez également ces références.

Après avoir regroupé les informations requises, vous pouvez convertir le projet pour Maven.

Procédure

  1. Cliquez avec le bouton droit de la souris sur le projet et sélectionnez Configurer > Convertir en projet Maven.
  2. Renseignez la boîte de dialogue POM de Maven. Entrez une valeur dans les zones ID du groupe, ID de l'artefact et Version ou acceptez les valeurs par défaut. En option, entrez un nom et une description. Dans la zone Packaging, choisissez une valeur en fonction des types de projet suivants :
    Projets Web
    war
    Projets EJB
    ejb
    Projets de connecteur, d'utilitaire, de fragment Web et de client EJB
    jar
    Projets du client d'application
    app-client
  3. Cliquez sur Terminer pour fermer la boîte de dialogue. L'éditeur POM s'ouvre. Si des références à d'autres projets ont été perdues, des erreurs de compilation peuvent s'afficher.
  4. Résolvez les erreurs de compilation. Convertissez les projets à référencer dans Maven, puis ajoutez des dépendances Maven à ces projets. Voir Ajout de dépendances à d'autres modules.
  5. Mettez à jour le projet. Après avoir changé le projet, cliquez avec le bouton droit de la souris sur le projet et sélectionnez Maven > Mettre à jour le projet.

Conversion de projets EAR

Pourquoi et quand exécuter cette tâche

La conversion de projets EAR implique plusieurs tâches :
  1. Créez un dossier de contenu.
  2. Convertissez le projet EAR.
  3. Ajoutez des modules à un projet EAR.
  4. Ajoutez des dépendances à d'autres modules.
  5. Ajoutez des bibliothèques au répertoire de bibliothèques EAR.
Procédez comme suit pour effectuer ces tâches.

Création d'un dossier de contenu

Pourquoi et quand exécuter cette tâche

Lorsqu'un projet EAR est créé dans WebSphere Application Server Developer Tools avec les préférences d'espace de travail par défaut, le répertoire de contenu du projet EAR est vide, ce qui signifie que tous les éléments dans le dossier racine du projet sont inclus dans le fichier EAR. Si le projet ne possède pas de dossier de contenu, vous devez créer un répertoire de contenu.

Procédure

  1. Déterminez si le projet EAR possède un dossier de contenu.
    1. Cliquez avec le bouton droit de la souris sur le projet et sélectionnez Propriétés > Assemblage de déploiement.
    2. Si vous voyez un dossier de contenu mappé à / (racine) comme dans l'image ci-dessous, le fichier EAR a un dossier de contenu différent de la racine du projet.
      Dossier de contenu non racine
    3. Si la racine du projet est mappée à la racine comme dans l'image suivante, cela signifie que le projet ne possède pas de répertoire de contenu :
      Le dossier de contenu est la racine
  2. Si le projet ne possède pas de dossier de contenu, cliquez sur Annuler dans la page Assemblage de déploiement et procédez comme suit pour en créer un :
    1. Cliquez avec le bouton droit de la souris sur le projet EAR et sélectionnez Nouveau > Dossier. Dans Nom du dossier, entrez le nom de la structure de dossiers. Pour les projets Maven, la structure de dossiers recommandée est src/main/application. Cliquez sur Terminer.
      Créer une structure de dossiers
    2. Accédez à la page de l'assemblage de déploiement. Cliquez avec le bouton droit de la souris sur le projet et sélectionnez Propriétés > Assemblage de déploiement.
    3. Sélectionnez l'entrée qui mappe la racine du projet à la racine du projet EAR et cliquez sur Supprimer.
    4. Cliquez sur Ajouter, sélectionnez Dossier et cliquez sur Suivant.
    5. Sélectionnez le dossier que vous avez créé et cliquez sur Terminer. Par exemple, si vous avez créé la structure de dossiers recommandée, sélectionnez le dossier application qui se trouve sous src/main.
      Sélectionner un dossier
    6. Vérifiez la structure. Désormais, la section de l'assemblage de déploiement comporte le dossier que vous avez créé et qui est mappé à la racine du projet. L'image ci-après représente l'exemple selon lequel vous avez créé un dossier src/main/application.
      Dossier mappé à la racine
    7. Cliquez sur OK pour terminer le mappage de l'assemblage de déploiement.
    8. Déplacez toutes les ressources que vous voulez inclure dans le projet EAR de la racine du projet vers le dossier que vous avez créé. Par exemple, si vous avez utilisé la structure de dossiers recommandée src/main/application et que le dossier EAR possède un descripteur de déploiement, déplacez le dossier META-INF de la racine du fichier EAR vers le dossier application.

Conversion du projet EAR

Pourquoi et quand exécuter cette tâche

Lorsque vous convertissez un projet, gardez à l'esprit les dépendances à d'autres artefacts et la façon dont le projet accède aux artefacts. Dans les projets autres que les projets Maven, ces informations sont spécifiées dans les métadonnées de projet et dans les fichiers MANIFEST.MF directement. Par contre, dans les projets Maven, les dépendances sont spécifiées dans le fichier pom.xml. Notez les modules qui font partie du projet EAR, les bibliothèques qui sont partagées avec d'autres modules utilisant le répertoire de bibliothèques (pour les projets EAR version 5 ou ultérieure), ou toute autre dépendance.

D'abord, utilisez la page de l'assemblage de déploiement pour regrouper les informations sur les dépendances :
  1. Cliquez avec le bouton droit de la souris sur le projet.
  2. Sélectionnez Propriétés > Assemblage de déploiement.
  3. Notez les modules qui font partie du projet EAR.
  4. Notez la valeur du répertoire de bibliothèques EAR si la version du projet EAR est la version 5 ou une version ultérieure.
  5. Notez les fichiers JAR et les projets qui se trouvent dans le répertoire de bibliothèques. Pour identifier ces fichiers, recherchez les fichiers JAR et les projets dont le chemin de déploiement commence par la valeur du répertoire de bibliothèques.
Remarque : Avant de convertir le projet, effectuez une copie de sauvegarde du fichier de descripteur de déploiement du projet EAR, META-INF/application.xml, s'il existe. Cette opération est nécessaire car au cours de la conversion, le descripteur de déploiement existant est remplacé par un descripteur de déploiement vide.

Procédure

  1. Cliquez avec le bouton droit de la souris sur le projet et sélectionnez Configurer > Convertir en projet Maven.
  2. Renseignez la boîte de dialogue POM de Maven. Entrez une valeur dans les zones ID du groupe, ID de l'artefact et Version ou acceptez les valeurs par défaut. En option, entrez un nom et une description. Dans la zone Packaging, entrez ear.
  3. Cliquez sur Terminer. L'éditeur POM s'ouvre.
    Remarque : Si le projet EAR possède un descripteur de déploiement, un nouveau descripteur de déploiement vide est généré. Si le descripteur de déploiement d'origine contenait des éléments tels que des rôles de sécurité, configurez les éléments dans le fichier pom.xml. Pour plus d'informations, voir Apache Maven EAR plugin.
  4. Mettez à jour le projet. Après avoir changé le projet, cliquez avec le bouton droit de la souris sur le projet et sélectionnez Maven > Mettre à jour le projet.
  5. Pour terminer la conversion du projet EAR, vous devez effectuer les trois tâches suivantes :
    1. Ajout de modules à un projet EAR
    2. Ajout de dépendances à d'autres modules
    3. Ajout de bibliothèques au répertoire de bibliothèques EAR
Icône indiquant le type de rubrique Rubrique de tâche
Dispositions pour les centres de documentation | Commentaires en retour

Icône d'horodatage Dernière mise à jour: May 29, 2014 10:11

Nom de fichier : convert.html