Leçon 1.2 : Création du service Web

Dans cette leçon, vous allez apprendre à créer le service Web EJB dans son intégralité.

1. Cliquez sur Fichier > Nouveau > Autre. Sélectionnez Services Web pour afficher les différents assistants des services Web. Sélectionnez l'assistant Service Web. Cliquez sur Suivant pour lancer l'assistant Service Web.
2. Dans la zone Type de service Web, sélectionnez Service Web EJB ascendant.
3. Sélectionnez votre implémentation de service à l'aide du bouton Parcourir. Une fenêtre s'ouvre et répertorie tous les beans enterprise disponibles. Sélectionnez le bean TestEJB.
4. Afin de créer un service et un client, et de démarrer ces deux éléments sur votre serveur, placez le curseur du service sur la position "Démarrer" et le curseur du client sur la position "Test". Cette procédure entraînera la création de tous les éléments appropriés suivants : code client, code service, projets et modules de routeur. Elle déclenchera également l'association de tous ces éléments au projet EAR adéquat, la création du code de déploiement, l'installation du projet EAR sur le serveur cible et le démarrage du service. Cependant, le service ne sera pas testé, car l'explorateur de services Web ne prend pas en charge Web services sur JMS.
5. Vérifiez que les options côté serveur suivantes sont sélectionnées :
   • Serveur : Serveur WebSphere v6.1
   • Environnement d'exécution : environnement d'exécution IBM WebSphere JAX-RPC
   • Projet du service : JMSService
   • Projet EAR du service : JMSEAR
   Vérifiez que les options côté client suivantes sont sélectionnées :
   • Serveur : Serveur WebSphere v6.1
   • Environnement d'exécution : environnement d'exécution IBM WebSphere JAX-RPC
   • Projet du client : JMSServiceEJBClient
   • Projet EAR du client : JMSServiceEJBClientEAR
   L'assistant créera pour vous les projets qui n'existent pas encore. Une fois toutes les options sélectionnées, vous devriez obtenir une fenêtre de ce type :
   
6. Dans la page Configuration EJB du service Web, sélectionnez la méthode de transport JMS et décochez la case HTTP. Le projet de routeur JMSServiceRouter importé avec JMSEAR doit être sélectionné. Cliquez sur Suivant. JMS n'étant pas compatible WS-I, un message d'erreur s'affiche (sauf si les paramètres de compatibilité WS-I ont été définis sur Ignorer). Vous pouvez cliquer sur Détails pour connaître la cause de l'erreur. Vous pouvez ignorer cet avertissement. Cliquez sur Ignorer.
7. Dans la page Configuration de liaison de service Web EJB, vous devrez entrer manuellement les valeurs suivantes pour les faire correspondre aux files d'attente et aux fabriques de connexion créées lors de la précédente leçon :
   • Vérifiez que la file d'attente est sélectionnée comme destination JMS. Ce tutoriel ne fonctionne pas pour les rubriques.
   • Indiquez jms/ws_tutorial_queue comme Nom JNDI de destination.
   • Indiquez jms/ws_tutorial_qcf comme Fabrique de connexions JMS.
   • Le nom du composant port correspond au nom du service cible. TestEJB sera donc utilisé comme nom du service cible.
   • Indiquez eis/ws_tutorial_JMSRoute comme Nom JNDI ActivationSpec.

   Une fois les valeurs indiquées, la page doit apparaître sous la forme suivante :

   

8. Dans la page Identité du bean Java de l'assistant, vous pouvez indiquer l'URI et la portée du service Web, ainsi que le nom des fichiers générés. Vous pouvez également sélectionner les méthodes qui doivent être incluses dans le service Web, indiquer le style de codage et configurer la sécurité du service Web. Cliquez sur Suivant pour accepter les valeurs par défaut.
   Important : L'URI (Uniform Resource Identifier) du service Web est automatiquement généré par l'assistant à partir de l'artefact sélectionné pour devenir un service Web. L'URI de base par défaut http://tempuri.org/ est utilisé pour former l'URI sans association unique à une entité. Le nom d'hôte tempuri provient de la spécification WSDL et correspond à un URI temporaire. Utilisez l'URI de base par défaut lorsque vous ne souhaitez pas que l'URI soit globalement unique. Il est déconseillé d'utiliser http://tempuri.org/ comme base pour des entités fixes et stables.
9. La page Proxy de service Web affiche l'emplacement de génération du code du proxy. Le proxy client fournit une interface RPC pour le service Web. N'activez pas la sécurité pour le proxy généré. Cliquez sur Suivant.
10. Utilisez la page Test du client du service Web pour sélectionner les options suivantes :
    • Sélectionnez l'option permettant de générer un exemple de page JSP du service Web à des fins de test.
    • Sélectionnez le dossier qui doit contenir la page JSP et vérifiez que toutes les méthodes sont incluses dans la page JSP.
    • Sélectionnez Exécuter le test sur le serveur pour démarrer automatiquement le serveur.
    Cliquez sur Terminer.
11. La page JSP du proxy est lancée dans un navigateur Web à l'adresse URL suivante : http://localhost:9080/JMSClient/sample/TestEJB/TestClient.jsp. Vous pouvez utiliser cet exemple d'application pour tester le service Web en sélectionnant une méthode, en entrant une valeur pour la méthode et en cliquant sur Appeler. Le résultat de la méthode, c'est-à-dire l'écho de la chaîne indiquée dans la zone de saisie, s'affiche dans la fenêtre des résultats.