Création d'un service Web de programme IBM i

Vous pouvez créer un service Web à partir d'un code source ILE RPG ou COBOL, ou à partir de fichiers PCML en utilisant l'assistant de service Web.
Avant de commencer

Démarrez le serveur d'applications avant d'exécuter l'assistant de service Web.

Dans la vue Serveurs (Fenêtre > Afficher la vue > Autre > Serveur > Serveurs), cliquez avec le bouton droit de la souris sur un serveur de la liste, puis sélectionnez Démarrer.

Vous pouvez rencontrer des erreurs si cette étape n'est pas terminée et le serveur peut mettre plusieurs minutes à démarrer.

Pourquoi et quand exécuter cette tâche
Cet ensemble d'outils propose deux approches de base pour créer un sevice Web de programme IBM® i :
  • A partir d'un source ILE RPG ou COBOL ou de fichiers PCML, vous pouvez utiliser l'assistant de service Web directement.
  • A partir des autres sources IBM i (notamment ILE C), vous pouvez utiliser l'assistant d'appel de programme pour produire un bean Java™ utilisable par la suite par l'assistant de service Web.
Cette tâche décrit le processus pour les programmes ILE RPG et COBOL.

Le programme de service Web IBM i peut servir à créer un composant de service d'entreprise dans une application d'intégration métier WebSphere Integration Developer.

Dans la perspective Explorateur de systèmes distants, la perspective de projets IBM i ou un projet Web dynamique, vous pouvez créer des services Web à partir d'un code source ILE RPG ou COBOL, ou à partir d'un fichier PCML.

Si vous commencez par l'explorateur de systèmes éloignés ou la perspective de projets IBM i, ou si vous utilisez la boîte de dialogue Recherche de fichier, toutes les informations de connexion que vous avez déjà définies sont utilisées par l'assistant de service Web.

  1. Cliquez avec le bouton droit de la souris sur l'objet source ILE RPG, COBOL ou PCML et sélectionnez Services Web > Créer un service Web.

    Si la bibliothèque contenant votre objet source n'apparaît pas dans la liste des bibliothèques, développez Objets, cliquez avec le bouton droit de la souris sur Liste des bibliothèques, sélectionnez Ajouter une entrée à la liste des bibliothèques et entrez le nom de votre bibliothèque dans la zone Bibliothèque supplémentaire.

    L'assistant de service Web s'ouvre alors. Il contient les données relatives à l'objet source sélectionné.
  2. Dans la zone Type de service Web, Service Web de programme ascendant IBM i devrait être mis en surbrillance. Si ce n'est pas le cas, sélectionnez-la dans la liste déroulante.
  3. Cliquez sur Parcourir pour ouvrir la fenêtre Sélection de l'implémentation de service.
  4. Vérifiez que le type de programme indiqué est correct, en particulier si vous souhaitez créer un service Web à partir d'un fichier source ILE RPG ou COBOL. Par défaut, la valeur qui apparaît dans la zone Type de programme est *SRVPGM ; il se peut que cette valeur soit incorrecte pour votre fichier source.
  5. Cliquez sur Parcourir en regard de la zone Configuration d'exécution pour rechercher les valeurs de configuration d'exécution et d'authentification ou cliquez sur Modifier pour les définir. Pour plus d'informations sur la définition des valeurs de configuration d'exécution et d'authentification, voir Configuration de l'environnement d'exécution de votre service Web IBM i.
  6. Lorsque vous revenez à la fenêtre Sélection de l'implémentation de service, cliquez sur OK pour définir ces valeurs et retourner à la première page de l'assistant de service Web.
  7. A l'aide du curseur, sélectionnez les opérations que vous souhaitez utiliser pour développer les services Web :
    • Développer : cette opération permet de développer la définition et l'implémentation WSDL du service Web. Elle consiste notamment à créer des modules destinés à recevoir le code, les fichiers WSDL, les descripteurs de déploiement et les fichiers Java générés, le cas échéant.
    • Assembler : cette opération permet d'associer le projet contenant le service Web ou le client à un fichier EAR lorsque le serveur d'applications cible le demande.
    • Déployer : cette opération permet de créer le code de déploiement correspondant au service.
    • Installer : cette opération consiste à installer et à configurer le module Web et les fichiers EAR sur le serveur cible.
    • Démarrer : grâce à cette opération, le serveur démarre dès que l'installation du service est terminée. Le fichier server-config-wsdd est alors généré.
    • Tester : cette opération permet de tester le service ; elle vous laisse pour cela plusieurs options et notamment celle d'utiliser l'explorateur de services Web ou des exemples de fichiers JSP.
  8. L'option Serveur affiche le serveur par défaut. Si vous souhaitez déployer votre service sur un autre serveur, cliquez sur Serveur, puis indiquez le serveur que vous souhaitez utiliser.
  9. L'option Environnement d'exécution du service Web affiche l'environnement d'exécution par défaut. Si vous souhaitez déployer votre service dans un environnement d'exécution différent, cliquez sur Environnement d'exécution du service Web, puis indiquez l'environnement d'exécution que vous souhaitez utiliser.
  10. L'option Projet de service affiche le projet de votre espace de travail qui contient le projet sélectionné. Si vous souhaitez spécifier un projet et un fichier EAR différents, cliquez sur le lien Projet de service. Veillez à ce que le projet que vous sélectionnez en tant que projet Web contenant le client soit différent du projet Web contenant le service. Sinon, le service sera écrasé par les artefacts du client.
  11. Si vous souhaitez créer un client, sélectionnez le type de proxy à générer dans la liste Type de client, puis répétez les opérations précédentes pour le client.
  12. Cochez la case Publier le service Web si vous souhaitez lancer l'explorateur de services Web afin qu'il publie votre service Web dans un annuaire UDDI.
  13. Cochez la case Surveiller le service Web pour transmettre le trafic du service Web au moniteur TCP/IP, qui vous permettra d'observer le trafic SOAP généré par le service Web et de vérifier ainsi la conformité à WS-I du projet de service spécifié. Vous avez également la possibilité de configurer manuellement un moniteur TCP/IP.
  14. Cliquez sur Terminer pour créer le service Web ou sur Suivant pour configurer les options avancées.

    L'assistant de service Web génère au minimum trois classes : nom_beanServices.java, nom_beanInput.java et nom_beanResult.java. La classe nom_beanServices.java requiert les classes nom_beanInput.java et nom_beanResult.java ; elles sont utilisées pour les paramètres d'entrée et de sortie de programme.

    Deux opérations de service Web sont générées pour chaque programme défini dans l'assistant de service Web. Vous pouvez utiliser l'une ou l'autre de ces opérations pour que les données vous soient renvoyées depuis l'appel de programme éloigné.

    La première opération renvoie les données de sortie au format XML. Le client de services Web peut récupérer les données en analysant la chaîne XML. La seconde opération renvoie les données de sortie dans la classe nom_beanResult.java. Le client des services Web peut récupérer les données en utilisant les méthodes getter de la classe.


Commentaires en retour