Spécification de packages d'API et de SPI pour un projet de fonction Liberty

Utilisez le fichier manifeste de la fonction Liberty pour déclarer les packages à partager en tant qu'API ou interface SPI avec d'autres applications et fonctions dans l'environnement d'exécution Liberty.

Pourquoi et quand exécuter cette tâche

Un package ne peut pas être déclaré en tant qu'API ou interface SPI sauf s'il est exporté par un bundle dans la fonction Liberty, en étant répertorié dans l'en-tête Export-Package du fichier manifeste du bundle.

Procédure

Pour spécifier des packages d'API et de SPI pour un projet de fonction Liberty, procédez comme suit :

  1. Dans la vue Explorateur de projets, ouvrez le fichier manifeste de fonction pour le projet de fonction Liberty en cliquant deux fois dans la hiérarchie du projet sur le noeud Manifeste indiqué par l'icône de manifeste (Capture d'écran de l'icône de manifeste).
  2. Pour mettre un ou plusieurs packages d'API à la disposition d'applications OSGi, cliquez sur Ajouter dans le panneau des packages d'API IBM.
  3. Lorsque vous créez votre propre fonction Liberty, vous l'installez dans l'extension de produit utilisateur, et tous les packages de votre fonction sont accessibles depuis les autres fonction installées dans l'extension de produit utilisateur. Pour mettre un ou plusieurs packages de SPI à la disposition de fonctions dans d'autres extensions de produit, cliquez sur Ajouter dans le panneau des packages de SPI IBM.
  4. (Facultatif) Spécifiez la version de package en sélectionnant le package, en cliquant sur Propriétés et en entrant la valeur de votre choix dans la zone Version.
  5. (Facultatif) Dans le cas d'un package d'API, sélectionnez le type de package dans la liste Type de la boîte de dialogue Propriétés. Les types sont les suivants :
    • spec - Indique une API fournie par un corps standard, comme javax.servlet ou org.osgi.framework.
    • ibm-api - Indique une API à valeur ajoutée fournie par IBM®.
    • api - Indique une API définie par l'utilisateur. Il s'agit de la valeur par défaut.
    • third-party - Indique une API qu'IBM peut voir mais ne contrôle pas. En général, il s'agit de packages à code source ouvert.
    • internal - Indique des packages autres que des API qui doivent être exposés aux applications pour qu'elles puissent fonctionner. Ils peuvent être utilisés si le code Java™ est amélioré au niveau du bytecode, ou tissé, pour ajouter des références au code interne à l'exécution.

Résultats

Les noms de package sont ajoutés dans les en-têtes IBM-API-Package et IBM-SPI-Package dans le fichier manifeste de fonction. Pour plus d'informations sur les en-têtes du fichier manifeste de fonction pour une fonction Liberty, voir Fichiers manifeste de fonction Liberty.


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

Nom du fichier : t_feature_project_specify_api_and_spi.html