Création d'un bean squelette Java à partir d'un document WSDL à l'aide de l'environnement d'exécution Apache Axis

L'assistant de service Web vous aide à créer un nouveau bean squelette à partir d'un fichier WSDL. Le bean squelette contient un ensemble de méthodes correspondant aux opérations décrites dans le document WSDL. Lors de la création du bean, chaque méthode est dotée d'une implémentation triviale que vous pouvez remplacer en modifiant le bean.

Prérequis :

  1. Si vous utilisez le conteneur du servlet Apache Jakarta Tomcat comme serveur, vous devez l'installer, configurer une instance de ce serveur et créer un projet Web conçu pour ce projet, conformément aux indications de la section Création d'un serveur Apache Tomcat et d'un projet Web
  2. Créez ou importez un fichier WSDL dans le dossier de contenu Web du projet Web. Vous pouvez uniquement utiliser un fichier WSDL contenant un élément de service.
Pour créer un service Web à partir d'un fichier WSDL utilisant l'environnement d'exécution Apache Axis 1.0, 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 fichier WSDL que vous avez créé ou importé dans le dossier de contenu Web 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 descendant, puis sélectionnez l'artefact à partir duquel créer 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 Configuration du squelette de bean Java du service Web : sélectionnez le dossier dans lequel le bean Java généré sera stocké. Pour consulter ou modifier les mappages entre les packages et les espaces de nom, cochez la case Définition d'un mappage personnalisé d'espace de nom vers le package. Cliquez sur Suivant.
  6. Page Mappage espace de nom client de service Web vers package: 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. Cliquez sur Suivant.
  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, cet écran affiche les options du proxy. Il indique le dossier dans lequel le proxy sera généré. Facultativement, vous pouvez créer des mappages personnalisés entre les espaces noms et les packages. Cliquez sur Suivant.
  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 : si vous avez choisi de publier votre service Web dans un registre UDDI, cette page permet de lancer l'explorateur de services Web et de sélectionner le registre UDDI sur lequel le service Web sera publié. Cliquez sur Terminer.
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.