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
- 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. 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Sélectionnez le package com.ibm.cics.server et cliquez sur OK. Le package s'affiche dans la liste Packages importés.
- 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. |
- 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.