Création d'un service Web à partir d'un bean Java à l'aide de l'environnement d'exécution Apache Axis

L'assistant de service Web vous aide à créer un nouveau service Web. Une fois votre service Web déployé, l'assistant vous aide à générer le proxy client et l'exemple d'application pour tester le service Web. Lorsque vous avez terminé le test, vous pouvez publier votre service Web dans un registre métier UDDI à l'aide de l'assistant d'exportation.

Prérequis :
  1. Crée ou importez un bean dans le dossier source Java du projet Web.
Pour créer un service Web à partir d'un bean à l'aide de l'environnement d'exécution Apache Axis, procédez comme suit :
  1. Basculez vers la perspective J2EE (Fenêtre > Ouvrir la perspective > J2EE).
  2. Dans la vue Explorateur de projets, sélectionnez le bean que vous avez créé ou importé dans le dossier source de votre projet Web.
  3. Cliquez sur Fichier > Nouveau > Autre. Sélectionnez Services Web pour afficher les différents assistants de service Web. Sélectionnez l'assistant de service Web. Cliquez sur Suivant.
  4. Page Services Web : Sélectionnez le type de service Web Service Web de bean Java ascendant, puis entrez l'URI du fichier WSDL, WSIL ou HTML qui sera utilisé pour générer le service.
    1. A l'aide du curseur, sélectionnez les étapes du développement de service Web que vous voulez exécuter :
      • Développement : création du code du service.
      • Assemblage :
      • Déploiement : création du code de déploiement pour le service.
      • Installation : installation du service sur le serveur sélectionné.
      • Démarrage : démarrage du serveur une fois le service installé sur le serveur.
      • Test : accès à différentes options de test du service.
    2. Sélection du serveur : affichage du serveur par défaut. Pour déployer votre service sur un autre serveur, cliquez sur le lien de sélection d'un autre serveur.
    3. Sélection de l'environnement d'exécution : affichage de l'environnement d'exécution par défaut. Pour déployer votre service dans un autre environnement d'exécution, cliquez sur le lien de sélection d'un autre environnement d'exécution.
    4. Sélection du projet de service : affichage du projet contenant le projet sélectionné dans votre espace de travail. Pour sélectionner un autre projet et un autre fichier EAR, cliquez sur le lien du projet. Vérifiez que le projet sélectionné comme projet Web client est différent du projet de service Web, sinon le service sera remplacé par les artefacts générés du client.
    5. Pour créer un client, sélectionnez le type de proxy à générer et répétez la procédure ci-dessus pour le client.
    6. Publication du service Web : lance l'explorateur de services Web afin de publier le service Web dans un registre UDDI.
    7. Contrôle du service Web : le trafic du service Web est envoyé via le Moniteur TCP/IP, ce qui vous permet de surveiller le trafic SOAP généré par le service Web et de tester la conformité de ce trafic à la norme WS-I. Une autre solution consiste à configurer manuellement un moniteur TCP/IP en procédant comme indiqué dans Utilisation du moniteur TCP/IP pour tester les services Web
  5. Page Identité du bean Java de service Web : le nom WSDL du service Web est indiqué. Vous avez le choix entre les options suivantes :
    • Sélectionnez les méthodes à exposer.
    • Sélectionnez le style de codage. Le style de codage conseillé est RPC/Encoded pour l'environnement d'exécution Axis. Cette méthode de codage n'est pas conforme à WS-I.
    • Indiquez si vous souhaitez personnaliser le package vers les mappages d'espace de nom.
    Cliquez sur Suivant.
  6. Page Mappage package de service Web vers espace de nom : si vous avez sélectionné Définition d'un mappage personnalisé du package vers l'espace de nom dans l'écran précédent, vous pouvez entrer vos paires de mappage personnalisés dans cet écran en cliquant sur Ajouter.
  7. Page d'essai du service Web : si vous avez choisi de tester le service Web, sélectionnez l'option de test pour le service Web généré. Le service Web est alors lancé dans l'explorateur de services Web. Sélectionnez l'opération à tester, entrez les informations requises, puis cliquez sur OK. Le résultat s'affiche dans le volet Statut. Cliquez sur Suivant.
  8. Page Proxy de service Web : si vous avez choisi de générer un proxy, indiquez si vous souhaitez personnaliser les mappages du package vers l'espace de nom.
  9. Page Test du client du service Web : cette page vous permet de sélectionner les options suivantes :
    1. Sélectionnez votre fonction de test. Vous pouvez tester le proxy généré dans l'explorateur de services Web, ou générer un exemple de JSP de service Web.
    2. Si vous avez choisi de tester le proxy via un JSP, vous pouvez sélectionner le dossier dans lequel va se trouver le JSP, ainsi que les méthodes à inclure dans le JSP.
    3. Sélectionnez Exécuter le test sur le serveur pour que le serveur démarre automatiquement.
  10. Page Publication du service Web : indiquez si vous souhaitez publier ce service Web dans un registre UDDI. Cliquez sur Terminer. Remarque : l'avertissement Erreur de génération de WSDL à partir de Java. ClassNotFound: <nom bean> peut s'afficher, mais n'en tenez pas compte.
Une fois le service Web créé, les événements suivants se produisent selon les options sélectionnées :
  • Si vous avez opté pour tester le proxy généré à l'aide des fichiers JSP de service Web, le proxy est lancé dans un navigateur Web à l'adresse URL suivante : http://localhost: port/ WebProjectClient/sampleBeanName/ WebServiceName/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 cette méthode, puis en cliquant sur Appeler. Le résultat de la méthode s'affiche dans la fenêtre de résultats.
  • Si vous avez choisi de tester le service Web avec l'explorateur de services Web, l'explorateur s'ouvre. Sélectionnez l'opération à tester, entrez les informations requises, puis cliquez sur OK. Le résultat s'affiche dans le volet Statut.
  • Si vous avez choisi de publier le service Web, l'explorateur de services Web est lancé et affiche la page requise pour publier votre service Web. Suivez les instructions de Publication du service Web pour exécuter cette tâche.

Important : si vos méthodes contiennent des types non pris en charge par l'exemple, par exemple des tableaux, des propriétés indexées et des collections, les méthodes sont omises des exemples et vous recevez un message d'avertissement.