Pour plateformes réparties

Configuration d'un projet Web pour qu'il utilise des bibliothèques partagées

Si vous avez un projet utilitaire défini en tant que bibliothèque partagée, vous pouvez l'associer à un projet Web.

Pourquoi et quand exécuter cette tâche

Une bibliothèque partagée est un fichier JAR (archive Java™) externe qui est utilisé par une ou plusieurs applications. L'utilisation de bibliothèques partagées permet à plusieurs applications publiées sur un serveur d'utiliser une bibliothèque unique au lieu de plusieurs copies de la même bibliothèque. Une fois que vous avez associé des bibliothèques partagées à une application ou à un projet, le chargeur de classe de l'application ou du module charge les classes qu'elles contiennent et les met à la disposition de l'application ou du module.

Procédure

  1. Pour configurer un projet Web afin qu'il utilise des bibliothèques partagées :
    1. Dans la vue Explorateur de projets, cliquez avec le bouton droit de la souris sur le projet Web auquel vous souhaitez associer des bibliothèques partagées.
    2. Sélectionnez Propriétés > Liberty > Bibliothèques partagées.
    3. Lorsque vous cliquez sur le bouton Ajouter, une liste des ID de la bibliothèque partagée s'affiche. Dans la zone ID, spécifiez l'identificateur de chaque bibliothèque partagée à laquelle le projet doit faire référence. Si vous spécifiez plusieurs ID, séparez-les par une virgule. Par exemple : ID1, ID2, ID3.
      Conseil : L'identificateur d'une bibliothèque partagée est la valeur que vous avez spécifiée dans la zone ID de bibliothèque partagée lorsque vous avez effectué la procédure Définir un projet utilitaire en tant que bibliothèque partagée.
  2. Pour les besoins de compilation, vous avez peut-être intérêt à ajouter les projets utilitaires au chemin de classes :
    1. Dans la vue Explorateur de projets, cliquez avec le bouton droit de la souris sur le projet Web auquel vous associez des bibliothèques partagées.
    2. Sélectionnez Propriétés > Chemin de génération Java.
    3. Cliquez sur l'onglet Projets.
    4. Cliquez sur Ajouter.
    5. Sélectionnez les projets utilitaires associés aux bibliothèques référencées par le projet Web.
  3. Facultatif : [16.0.0.4 et ultérieur]Définissez la visibilité d'API.
    1. Cliquez sur un projet Web avec le bouton droit de la souris.
    2. Sélectionnez Liberty > Bibliothèques partagées.
    3. Utilisez les cases suivantes pour définir la visibilité d'API : API, IBM API, Spec et Tiers. La visibilité par défaut est définie pour API, IBM API et Spec.
  4. Développez les artefacts à inclure dans le projet Web. Par exemple, vous pouvez lui ajouter un servlet faisant référence à des classes disponibles dans les bibliothèques partagées.
  5. Ajoutez le projet Web au serveur. Pour plateformes répartiesPour plus de détails, voir Déploiement d'applications sur des serveurs Liberty à l'aide des outils de développement.

Résultats

Voici un exemple d'entrée ajoutée à la configuration du serveur (fichier server.xml) :
<application type="war" id="web" name="web" location="web.war">
	<classloader commonLibraryRef="libid"/>
</application>

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : t_associate_shared_library.html