Développement de services Web IBM i sans fichier source

Vous pouvez utiliser l'assistant d'appel de programme pour créer un bean Java™ et un fichier PCML à partir d'une procédure de programme de service IBM® i, puis utiliser l'assistant de services Web pour créer un service Web à partir d'un bean Java et d'un fichier PCML.

Utilisez l'assistant d'appel de programme pour générer un bean Java et un fichier PCML :

Avant de commencer
Pourquoi et quand exécuter cette tâche
  1. Ouvrez une perspective Web.
  2. Créez un nouveau projet Web dynamique.
  3. Dans l'explorateur de projets, sélectionnez le projet.
  4. Dans la barre de menus du plan de travail, cliquez sur l'icône Créer un bean d'appel de programme.. L'assistant Appel de programme apparaît. Si vous disposez déjà d'un fichier PCML contenant les définitions pour le programme IBM i, vous pouvez l'importer dans l'assistant pour créer le bean Java. Dans le cas contraire, utilisez l'assistant pour créer des définitions de programme et de paramètre :
    1. Dans la page Ajouter un programme, entrez le nom que vous souhaitez affecter à votre bean Java, le nom de l'objet de programme et le nom de la bibliothèque le contenant. Vous pouvez cliquer sur Parcourir pour rechercher le programme que vous souhaitez appeler depuis votre serveur IBM i.
    2. Cliquez sur OK. Cela définit le programme ou la procédure à appeler.
    3. Dans la page Ajout de paramètre, entrez le nom, la longueur, le type de données et l'usage de chaque paramètre. Cliquez sur OK.
  5. Cliquez sur Suivant pour passer à la page suivante de l'assistant.
  6. Dans la zone Package, indiquez le nom du package où vous souhaitez créer les fichiers. Vous pouvez indiquer un nouveau nom de package.
  7. Vérifiez que la case Services Web est cochée.
  8. Cliquez sur Suivant pour détailler les informations de configuration qui doivent être sauvegardées dans le fichier de configuration d'exécution.
    1. Sous Authentification, complétez les zones Nom d'hôte, ID utilisateur et Mot de passe.
    2. Cliquez sur l'onglet Liste des bibliothèques, tapez le nom de la bibliothèque renfermant le programme IBM i dans la zone Bibliothèque, puis cliquez sur Ajouter.
  9. Cliquez sur Terminer.
Résultats

L'assistant Appel de programme génère trois classes. L'une d'entre elles est un bean Java que l'assistant de services Web peut utiliser pour créer un service Web. Elle s'appelle nom_beanServices.java. Les deux autres classes s'appellent nom_beanInput.java et nom_beanResult.java. La classe de bean Java requiert ces classes pour les paramètres d'entrée et de sortie.

Utilisez l'assistant de services Web pour créer un service Web à partir du bean Java et du fichier PCML :

Avant de commencer

Pour chaque programme que vous avez défini dans l'assistant d'appel de programme, deux méthodes sont générées. Vous pouvez utiliser l'une ou l'autre de ces méthodes pour que les données vous soient renvoyées depuis l'appel de programme distant.

  • La première méthode renvoie les données de résultat au format XML. Le client de services Web peut récupérer les données en analysant la chaîne XML.
  • La seconde méthode 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.
Pourquoi et quand exécuter cette tâche
Maintenant, vous pouvez utiliser l'assistant de services Web pour créer un service Web à partir des classes créées par l'assistant Appel de programme.
  1. Dans l'explorateur de projets, sélectionnez nom_beanServices.java sous Java Resources et Nom du package.
  2. Sélectionnez Fichier > Nouveau > Autre > Services Web > Service Web. Vous devrez probablement cocher la case Afficher tous les assistants.
  3. Cliquez sur Suivant.
  4. Dans la zone Type de service Web, l'entrée Bottom up Java bean Web Service doit être mise en évidence. Si ce n'est pas le cas, sélectionnez-la dans la liste déroulante.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. Si vous souhaitez créer un client, sélectionnez le type de proxy à générer et répétez les opérations précédentes pour le client.
  10. 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.
  11. 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.
  12. Cliquez sur Suivant pour accéder à la page Sélection de l'interface de terminaison du service.
  13. Cliquez sur Suivant pour accéder à la page Identité du bean Java de service Web.
  14. Cliquez sur Suivant. Si la page de l'assistant de démarrage du serveur s'affiche, cliquez sur le bouton Démarrer le serveur, puis, une fois le serveur démarré, cliquez sur Terminer.
  15. Sur la page Tester le service Web, sélectionnez l'entrée Explorateur de services Web de la zone Fonction de test.
  16. Cliquez sur Terminer pour lancer le service Web dans le navigateur. Une fois le test de votre service Web terminé, vous pouvez fermer la page du navigateur.
  17. Vous pourrez exécuter le service Web ultérieurement en cliquant avec le bouton droit de la souris sur le fichier TestClient.jsp de votre projet Web et en sélectionnant Exécuter en tant que > Exécuter sur le serveur.
Résultats

Commentaires en retour