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
Résultats
Exemple
$AdminApp edit MultiEjbJar {-WebServicesClientBindDeployedWSDL {{ejbclientonly.jar Exchange
service/StockQuoteService META-INF/wsdl/AlternateStockQuoteFetcher.wsdl}...}}