Conversion d'un projet Java existant en projet de plug-in

Si vous disposez d'un projet Java existant, vous pouvez le convertir en un projet de plug-in OSGi. 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 suppose que vous disposez d'un projet Java existant dans votre espace de travail et que vous voulez le convertir en projet de plug-in OSGi.

Procédure

  1. Dans la vue Explorateur de packages, cliquez avec le bouton droit de la souris sur le projet Java que vous voulez convertir en projet de plug-in et cliquez sur Configurer > Convertir en projets de plug-in. La boîte de dialogue Convertir des projets existants s'affiche.
    Une capture d'écran de la boîte de dialogue Convertir des projets existants affiche quatre projets Java disponibles pour la conversion. Toutefois, un seul d'entre eux est actuellement sélectionné.
    La boîte de dialogue contient une liste de tous les projets Java dans votre espace de travail. Celui que vous choisissez de convertir est sélectionné. Vous pouvez changer votre sélection ou sélectionner plusieurs projets Java à convertir en projet de plug-in.
  2. Cliquez sur Terminer. Lorsque vous cliquez sur Terminer, le ou les projets Java sont convertis en projets de plug-in. Le nom du projet ne change pas, mais les projets contiennent désormais un fichier manifeste et un fichier de propriétés build.properties.
  3. 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.
    Remarque : Dans les versions de CICS antérieures à la version 4.2 de CICS TS, vous deviez ajouter la bibliothèque de classes Java, dfjcics.jar, au chemin de génération Java. Dans la version 4.2 de CICS TS, OSGi gère le chemin de génération à votre place. Avant d'exécuter les étapes suivantes, vous devez éditer le chemin de génération actuel et supprimer toute référence à dfhjcics.jar. Si vous ne supprimez pas toutes les références à dfhjcics.jar, une erreur NoSuchMethodException se produit lors de l'exécution.
    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 manifeste. Le fichier manifeste s'ouvre dans l'éditeur de fichier manifeste.
    2. Important : Dans les versions CICS antérieures à la version 4.2 de CICS TS, la bibliothèque de classes Java, aussi appelée JCICS, est disponible dans le fichier JAR dfjcics.jar. Dans la version 4.2 de CICS TS, la bibliothèque est disponible dans le fichier com.ibm.cics.server.jar. Si le fichier manifeste de votre projet contient la déclaration : Import-Package: dfhjcics.jar;, vous devez supprimer la déclaration avant d'exécuter les étapes restantes.
    3. 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.
    4. Sélectionnez le package com.ibm.cics.server et cliquez sur OK. Le package s'affiche dans la liste Packages importés.
    5. Facultatif : Facultatif : Répétez l'étape précédente pour installer les packages suivants, 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.
    6. Appuyez sur Ctrl +S pour sauvegarder le fichier manifeste.

Résultats

Vous avez correctement converti votre projet Java existant en projet de plug-in. 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.