Publication de fichiers WSDL à l'aide de l'outil de scriptage wsadmin

Les fichiers WSDL (Web Services Description Language) de chaque module compatible avec des services Web sont publiés dans le système de fichiers que vous définissez. Vous pouvez fournir ces fichiers WSDL lors du processus de développement et de configuration des clients de services Web afin qu'ils puissent appeler les services Web.

Avant de commencer

Avant de publier un fichier WSDL, vous pouvez configurer des services Web pour définir les informations du noeud final sous forme de fragments URL pour activer la spécification complète des ports WSDL. Reportez-vous aux tâches décrivant les informations d'URL de noeud final.

Pour publier un fichier WSDL (Web Services Description Language), vous devez disposer d'une application d'entreprise, également appelée fichier EAR (enterprise archive), contenant un module compatible avec les services Web et ayant été déployée vers WebSphere Application Server. Pour plus d'informations, voir Déploiement d'applications de services Web sur des serveurs d'applications.

Pourquoi et quand exécuter cette tâche

L'objectif de la publication du fichier WSDL est de fournir aux clients une description du service WSDL, avec l'URL identifiant l'emplacement du service.

A l'issue de l'installation d'une application de services Web et d'une modification éventuelle des informations du noeud final, vous pouvez avoir besoin des fichiers WSDL stockant les informations du noeud final mises à jour. Vous pouvez obtenir les fichiers WSDL mis à jour en les publiant sur le système de fichiers. Si vous êtes un développeur de client ou un administrateur système, vous pouvez utiliser les fichiers WSDL pour permettre aux clients de se connecter à un service Web.

L'outil wsadmin peut publier les fichiers WSDL soit en mode local, par exemple -conntype NONE, soit en mode distant. Cependant, en mode local, l'application cible doit se trouver sur le noeud à partir duquel la commande wsadmin est appelée.

Les étapes suivantes supposent que l'application a été déployée et que le serveur d'applications est en cours d'exécution.

Procédure

  1. A l'invite de commande, démarrez l'outil wsadmin à l'aide des commandes suivantes :
    • [Windows]profile_root\bin\wsadmin
    • [Linux][IBM i][z/OS]profile_root/bin/wsadmin
  2. A l'invite de commande wsadmin, entrez l'une des deux commandes suivantes :
    • $AdminApp publishWSDL nom_app chemin
    • $AdminApp publishWSDLnom_app chemin préfixesAdresseSOAP
    où :
    • nom_app est le nom de l'application
    • chemin est le chemin d'accès absolu au fichier compressé qui contient les fichiers WSDL publiés. Le fichier compressé est sauvegardé sur la machine qui exécute WebSphere Application Server. Par conséquent, si le serveur s'exécute sur une autre machine, vous devez obtenir le fichier compressé de celle-ci. La structure de répertoires du fichier compressé résultant est fonction des informations suivantes :
      nom_fichier_application/nom_fichier_module/META-INF/ ou WEB-INF/wsdl/nom_fichier_WSDL
      Reportez-vous au scénario d'utilisation pour obtenir un exemple de cette structure de répertoires.
    • préfixesAdresseSOAP est un paramètre de la forme {{module {{liaison url-partielle}}}}. Ce paramètre décrit l'URL partielle de chaque liaison, module par module.
      • module identifie le module.
      • liaison est soit http, soit jms (ils doivent être spécifiés en minuscules)
      • url-partielle est l'adresse SOAP partielle de la liaison SOAP associée. Pour une liaison HTTP, la forme est http://hôte:port/ ou https://hôte:port.
        Pour les liaisons, Java Message Service (JMS), la forme est
        jms:/queue?destination=dest&connectionFactory=cf
        ou
        jms:/topic?destination=dest&connectionFactory=cf

    Utilisez la commande $AdminApp publishWSDL nom_app chemin pour publier des fichiers WSDL avec des URL de noeud final par défaut. Si vous souhaitez mettre à jour les préfixes d'adresse SOAP du fichier WSDL, utilisez l'autre commande.

    Utilisez la commande $AdminApp publishWSDL nom_app chemin {{module {{liaison url-partielle}}}} pour personnaliser l'adresse SOAP WSDL de chaque module. Vous pouvez indiquer un préfixe d'adresse différent pour chaque liaison SOAP.

Résultats

Les fichiers WSDL de services Web sont publiés dans un fichier compressé spécifique. Le fichier compressé peut être utilisé pour créer un client de service Web qui accède au service déployé. Les fichiers WSDL publiés ne contiennent pas d'informations de liaison d'EJB.

Exemple

La commande permettant de publier des fichiers WSDL pour un service Web nommé $AdminApp publishWSDL WebServicesSamples c:/temp/samplesWsdl.zip

ou

$AdminApp publishWSDL WebServicesSamples c:/temp/sampleswsdl.zip { {AddressBookJ2WB.war {{http http://localhost:9080}}} {StockQuote.jar {{http https://localhost:9443}}} }

La structure de répertoires du fichier compressé créé est la suivante :
WebServicesSamples.ear/StockQuote.jar/META-INF/wsdl/StockQuoteFetcher.wsdl 
WebServicesSamples.ear/AddressBookW2JE.jar/META-INF/wsdl/AddressBookW2JE.wsdl 
WebServicesSamples.ear/AddressBookJ2WE.jar/META-INF/wsdl/AddressBookJ2WE.wsdl 
WebServicesSamples.ear/AddressBookJ2WB.war/WEB-INF/wsdl/AddressBookJ2WB.wsdl 
WebServicesSamples.ear/AddressBookW2JB.war/WEB-INF/wsdl/AddressBookW2JB.wsdl

Que faire ensuite

Développez un client de services Web ou configurez les informations du noeud final d'un service Web existant.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_commandwsdl
Nom du fichier : txml_commandwsdl.html