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 :
- 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é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 :
- Basculez vers la perspective J2EE (Fenêtre > Ouvrir la
perspective
> J2EE).
- Dans la vue Explorateur de projets, sélectionnez le bean que vous
avez créé ou importé dans le dossier source 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 ascendant, puis entrez l'URI du fichier
WSDL, WSIL ou HTML qui sera utilisé pour générer 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 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.
- 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.
- 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,
indiquez si vous souhaitez personnaliser les mappages du package vers l'espace
de nom.
- 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 : 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.