Configuration d'un nom de fichier WSDL déployé pour un client de services Web à l'aide de l'outil wsadmin

Lorsqu'une application de services Web est déployée sur WebSphere Application Server, une instance est créée pour chaque application ou module. L'instance contient des informations de déploiement pour le module Web ou EJB (Enterprise JavaBeans), y compris les liaisons du client.

Avant de commencer

L'application de service Web doit être prête à être déployée ou bien vous avez déjà déployé le service Web dans WebSphere Application Server avant de lancer cette tâche.

Pour accomplir cette tâche, vous devez connaître la topologie des adresses URL des noeuds finals des serveurs de services Web et savoir de quel service Web le client dépend. Vous pouvez afficher les descripteurs de déploiement sur la console d'administration pour rechercher les informations de topologie. Pour plus de détails, consultez les informations sur la visualisation des descripteurs de déploiement du serveur de services Web dans la console d'administration.

Pour plus d'informations sur les options de l'outil wsadmin, voir Options des commandes install, installInteractive, edit, editInteractive, update et updateInteractive de l'objet AdminApp.

Pourquoi et quand exécuter cette tâche

Les liaisons du client définissent le nom du fichier WSDL et les ports à utiliser de préférence. Le chemin relatif d'un service Web dans un module est spécifié à l'intérieur d'un fichier WSDL compatible qui contient l'URL proprement dite à utiliser pour les demandes. L'adresse est seulement nécessaire si le fichier WSDL d'origine ne contenait pas d'URL, ou lorsqu'une adresse différente est requise. Pour un noeud final de service avec ports multiples, vous devez définir un nom de fichier WSDL de rechange.

Les étapes ci-après expliquent comment modifier les liaisons d'un service Web après leur déploiement sur un serveur. Lorsqu'un service Web communique avec un autre service Web, vous devez configurer les liaisons du client pour permettre l'accès au service Web en aval.

Vous pouvez utiliser l'option de ligne de commande WebServicesClientBindDeployedWsdl dans cette tâche pour changer de noeud final. L'utilisation de l'option de ligne de commande présente l'avantage suivant : vous n'avez pas à désinstaller et modifier les fichiers EAR, ou à réinstaller des applications pour effectuer les modifications de configuration de liaisons. Vous pouvez également personnaliser les applications de liaisons de service Web pour différents environnements lors de l'installation, sans avoir à créer différents fichier EAR d'application pour chaque version.

Plusieurs versions de fichiers WSDL, chacun avec différents noeuds finals de services, peuvent être fournies lors du développement et de l'assemblage d'un module de service Web qui sert de client à un service Web. Pendant ou après l'installation, lorsque vous configurez l'application installée, vous pouvez spécifier l'option WebServicesClientBindDeployedWsdl pour indiquer quel fichier WSDL utiliser.

Dans la mesure où le fichier WSDL définit tous les noeuds finals de services ou les implémentations pour tous les types de ports et tous les ports que le client peut utiliser, le fichier WSDL déployé peut regrouper plusieurs options en un seul fichier WSDL. Vous pouvez remplacer le noeud final par un port.

Vous pouvez également exécuter les scripts Jacl et Jython, mais cette tâche suppose que vous utilisez Jacl. Pour plus d'informations sur le déploiement et la gestion à l'aide des scripts, voir Utilisation du scriptage.

Pour configurer des liaisons de client à l'aide de l'outil wsadmin, procédez comme suit :

Procédure

  1. Lancez une commande de script. Pour plus d'informations, voir Démarrage du client de scriptage wsadmin.
  2. Dans l'invite de commande wsadmin, entrez la syntaxe de la commande. Vous pouvez utiliser les options install, installInteractive, edit ou editInteractive. Les exemples suivants illustrent la syntaxe :
    $AdminApp edit <app_name> { 
    -WebServicesClientBindDeployedWsdl {{<module_name> <EJB_name> <web_service> 
    <deployed_WSDL_filename>}...} 
    L'exemple mentionne plusieurs modules et noeuds finals d'URL car vous pouvez éditer plusieurs fragments d'URL. où :
    • nom_app est le nom de l'application (par exemple, WebServicesSample.ear).
    • nom_module est le nom du module EJB ou Web, par exemple AddressBookW2JE.jar.
    • nom_EJB est le nom de l'EJB si le module n'est pas un module Web (par exemple, Exchange).
    • service_web est le nom du service Web, par exemple, service/StockQuoteService.
    • nomfichier_WSDL_déployé identifie le fichier WSDL, par rapport à ce module, par exemple, META-INF/wsdl/AlternativeStockQuoteFetcher.wsdl.
  3. Sauvegardez les modifications apportées à la configuration avec la commande $AdminConfig save.

Résultats

Les liaisons du client de votre service Web sont configurées.

Exemple

L'exemple suivant présente l'application, le module et le nom de fichier déployé tel qu'il est écrit dans la ligne de commande :
$AdminApp edit MultiEjbJar {-WebServicesClientBindDeployedWSDL {{ejbclientonly.jar Exchange 
service/StockQuoteService META-INF/wsdl/AlternateStockQuoteFetcher.wsdl}...}} 

Que faire ensuite

Vous pouvez désormais terminer les autres configurations, démarrer ou redémarrer l'application, puis vérifier le comportement attendu du service Web.

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_clientbindingswsadmin
Nom du fichier : txml_clientbindingswsadmin.html