Importation du contenu d'un fichier JAR dans un projet de plug-in OSGi

Vous pouvez créer un projet de plug-in à partir d'un fichier JAR existant. Cette méthode est utile lorsque l'application autorise déjà des unités d'exécution multiples. Aucune refactorisation ou aucun recompilage n'est requis. Le regroupement OSGi peut s'exécuter dans un environnement JVM et un serveur JVM groupé.

Pourquoi et quand exécuter cette tâche

Cette tâche crée un nouveau projet de plug-in OSGi à partir d'un fichier JAR existant. Ce fichier doit se trouver sur votre système de fichiers local.

Procédure

  1. Dans la barre de menus Eclipse, cliquez sur Fichier > Nouveau > Projet pour ouvrir l'assistant de création.
  2. Développez le dossier Développement du plug-in et cliquez sur Plug-in issu des archives JAR existantes. Cliquez sur Suivant. La boîte de dialogue Sélection du fichier JAR s'ouvre.
  3. Localisez le fichier JAR à convertir. Si le fichier se trouve dans votre espace de travail Eclipse, cliquez sur Ajouter. Si le fichier se trouve dans un dossier sur votre ordinateur, cliquez sur Ajouter un fichier externe et accédez au fichier JAR. Sélectionnez le fichier requis et cliquez sur Ouvrir pour l'ajouter à la boîte de dialogue Sélection du fichier JAR. Cliquez sur Suivant. La boîte de dialogue Propriétés du projet de plug-in s'ouvre.
    Capture d'écran de l'assistant Nouveau plug-in issu des archives JAR existantes
  4. Dans la zone Nom de projet, entrez le nom du projet que vous voulez créer. Le nom de projet est obligatoire.
  5. Renseignez les zones suivantes dans la section Propriétés du plug-in, le cas échéant :
    ID du plug-in
    L'ID du plug-in est automatiquement généré à partir du nom du projet. Toutefois, vous pouvez changer l'ID si vous le souhaitez.
    Nom du plug-in
    Le nom du plug-in est automatiquement généré à partir du nom du projet. Toutefois, vous pouvez changer son nom si vous le souhaitez.
    Environnement d'exécution
    Cette zone indique le niveau minimum requis du JRE pour exécuter le plug-in. Sélectionnez le niveau Java™ correspondant à l'environnement d'exécution dans votre plateforme cible d'exécution CICS.
  6. Dans la section Plateforme cible, sélectionnez une infrastructure OSGI et sélectionnez standard dans le menu.
  7. Vérifiez que l'option Décompresser les archives JAR dans le projet est sélectionnée, puis cliquez sur Terminer. Eclipse crée le projet de plug-in dans l'espace de travail.
  8. Obligatoire : Obligatoire : Vous devez maintenant éditer le fichier manifeste du plug-in et ajouter les dépendances de l'API JCICS. Si vous n'exécutez pas ces étapes, vous pourrez exporter et installer le regroupement, mais sans pouvoir l'exécuter.
    1. Dans la vue Explorateur de packages, cliquez avec le bouton droit de la souris sur le nom du projet et cliquez sur Outils PDE > Ouvrir le fichier manifeste. Le fichier manifeste s'ouvre dans l'éditeur de fichier manifeste.
    2. Sélectionnez l'onglet Dépendances et dans la section Packages importés, cliquez sur AJOUTER. La boîte de dialogue Sélection de packages s'ouvre.
    3. Sélectionnez le package com.ibm.cics.server et cliquez sur OK. Le package s'affiche dans la liste Packages importés.
    4. Facultatif : Facultatif : Répétez l'étape précédente pour installer le package suivant, si votre application l'exige :
      Tableau 1.
      Package Description
      com.ibm.record API Java des programmes existants qui utilisent IByteBuffer dans l'infrastructure d'enregistrement Java disponible avec VisualAge. Précédemment disponible dans le fichier dfjcics.jar.
    5. Appuyez sur Ctrl +S pour sauvegarder le fichier manifeste.

Résultats

Vous avez créé un projet de plug-in OSGi à partir d'un fichier JAR existant. Toutefois, vous devez maintenant mettre à jour le fichier manifeste afin d'ajouter une déclaration CICS-MainClass. Pour plus d'informations, reportez-vous aux liens connexes.