Configuration de fichiers POM de dépendance émulant le chemin de classe d'environnements d'exécution WebSphere spécifiques
Vous pouvez utiliser des fichiers POM (Project Object Model) cible en tant que dépendances Maven. Ces dépendances émulent le chemin d'accès aux classes des environnements d'exécution WebSphere pour la compilation de votre application Java EE et OSGi.
Pourquoi et quand exécuter cette tâche
La configuration du fichier POM cible dépend de la version de WebSphere Application Server Liberty ou Traditional que vous utilisez.
Procédure
- Pour WebSphere Application Server Liberty version 8.5.5.8 ou ultérieure,
procédez comme suit :
- Choisissez la version applicable de l'un des fragments suivants des
dépendances Maven.
Les fragments suivants font partie du référentiel ci.maven.tools GitHub de Maven Central.
- liberty-target
Cette dépendance agrège toutes les API et SPI de WebSphere Application Server Liberty, ainsi que les dépendances de spécification Java recommandées et les dépendances d'implémentation tierces.
<dependency> <groupId>net.wasdev.maven.tools.targets</groupId> <artifactId>liberty-target</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>- liberty-apis
Cette dépendance inclut les dépendances d'API WebSphere Application Server Liberty. Elle indique toutes les bibliothèques d'API du répertoire dev/api/ibm/ d'une installation Liberty.
<dependency> <groupId>net.wasdev.maven.tools.targets</groupId> <artifactId>liberty-apis</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>- liberty-spis
Cette dépendance inclut les dépendances de SPI WebSphere Application Server Liberty. Elle indique toutes les bibliothèques de SPI du répertoire dev/spi/ibm/ d'une installation Liberty.
<dependency> <groupId>net.wasdev.maven.tools.targets</groupId> <artifactId>liberty-spis</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>- java-specs
Cette dépendance inclut les dépendances de spécification Java. Elle peut satisfaire toutes les bibliothèques de spécification Java recommandées des répertoires dev/api/ibm/ et dev/spi/ibm/ d'une installation Liberty.
<dependency> <groupId>net.wasdev.maven.tools.targets</groupId> <artifactId>java-specs</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>- third-party
Cette dépendance inclut les dépendances d'implémentation tierce. Elle peut satisfaire les bibliothèques tierces des répertoires dev/api/third-party et dev/spi/third-party d'une installation Liberty.
<dependency> <groupId>net.wasdev.maven.tools.targets</groupId> <artifactId>third-party</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>
- Modifiez la variable
RELEASE en indiquant votre version de
WebSphere Application Server Liberty.
Par exemple, modifiez RELEASE en 8.5.5.9 pour WebSphere Application Server Liberty version 8.5.5.9.
Conseil : Si vous n'éditez pas la valeur RELEASE, les outils utilisent par défaut la version disponible la plus récente. - Utilisez les fragments suivants pour spécifier les API d'environnement d'exécution à employer pour compiler les applications Java EE et OSGi.
- Choisissez la version applicable de l'un des fragments suivants des
dépendances Maven.
- Dans le cas de WebSphere Application Server Liberty version 8.5.5.4,
8.5.5.5, 8.5.5.6 ou 8.5.5.7, procédez comme indiqué ci-après.
- Configurez le référentiel IBM Maven en référentiel distant Maven pour
indiquer la dépendance qui émule le chemin d'accès aux classes de votre
environnement d'exécution.
Pour plus d'informations sur la configuration du référentiel IBM Maven, voir Configuration du référentiel IBM Maven.
- Choisissez la version applicable de l'une des dépendances suivantes.
- was-liberty
Cette dépendance satisfait toutes les API et SPI de WebSphere Application Server Liberty, ainsi que toutes les dépendances de spécification Java recommandées.
<dependency> <groupId>com.ibm.tools.target</groupId> <artifactId>was-liberty</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>- was-liberty-impl
Cette dépendance contient les bibliothèques d'implémentation tierces, telles qu'Open JPA, Wind et Jackson.
<dependency> <groupId>com.ibm.tools.target</groupId> <artifactId>was-liberty-impl</artifactId> <version>RELEASE</version> <type>pom</type> <scope>provided</scope> </dependency>
- Modifiez la variable
RELEASE en indiquant la version de la
dépendance Maven qui correspond à votre version de WebSphere Application
Server Liberty.
Vous pouvez utiliser le tableau suivant pour déterminer la version de dépendance Maven correspondant à votre version de WebSphere Application Server Liberty :
Version de WebSphere Application Server Liberty Version de la dépendance Maven 8.5.5.9 8.5.x.6 ou RELEASE 8.5.5.8 8.5.x.5 8.5.5.7 8.5.x.4 8.5.5.6 8.5.x.3 8.5.5.5 8.5.x.2 8.5.5.4 8.5.x.1 Vous pouvez, par exemple, modifier RELEASE en 8.5.x.2 pour WebSphere Application Server Liberty version 8.5.5.5.
Conseil : Si vous n'éditez pas la valeur RELEASE, les outils utilisent par défaut la version disponible la plus récente.
- Configurez le référentiel IBM Maven en référentiel distant Maven pour
indiquer la dépendance qui émule le chemin d'accès aux classes de votre
environnement d'exécution.
- Pour WebSphere Application Server Traditional, voir Installation des API de serveur dans le référentiel Maven.