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
- Dans la barre de menus Eclipse, cliquez sur Fichier > Nouveau > Projet pour ouvrir
l'assistant de création.
- 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.
- 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.
- Dans la zone Nom de projet, entrez le nom
du projet que vous voulez créer. Le nom de projet est obligatoire.
- 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.
- Dans la section Plateforme cible, sélectionnez une infrastructure OSGI et sélectionnez standard dans le menu.
- 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.
- 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.
- 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.
- 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 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. |
- 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.