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 :
- 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
- 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 :
- Basculez vers la perspective J2EE (Fenêtre > Ouvrir la
perspective
> J2EE).
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Publication du service Web : lance l'explorateur de services Web afin de
publier le service Web dans un registre UDDI.
- 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
- 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.
- 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.
- 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.
- 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.
- Page Test du client du service Web : cette page vous permet de
sélectionner les options suivantes :
- 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.
- 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.
- Sélectionnez Exécuter le test sur le serveur pour
que le serveur démarre automatiquement.
- 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.