Configuration des mappages de port préférés du client de services Web à l'aide de l'outil de scriptage wsadmin
Un type de port de client peut être défini avec des ports de différentes qualités de service. Vous pouvez utiliser l'option de ligne de commande WebServicesClientBindPreferredPort pour spécifier le port à utiliser.
Avant de commencer
Si vous n'avez pas encore déployé le fichier EAR (d'archive d'entreprise), vous devez le préparer ou le déployer sur le serveur d'applications.
Pourquoi et quand exécuter cette tâche
Pour chaque type de port configuré, un ou plusieurs ports peuvent être sélectionnés pour implémenter ce type de port. Lorsqu'un client de services Web appelle une méthode getPort, le mappage de port préféré détermine le port à utiliser. Cette détermination a lieu lorsque plusieurs ports peuvent satisfaire l'appel de la méthode getPort, comme un appel getPort qui spécifie le type de port, mais pas le port lui-même. Par exemple, supposons que le client de services Web est configuré pour utiliser JMS (Java Message Service) et une implémentation HTTP. Lors de l'installation ou de la gestion, vous pouvez utiliser la commande WebServicesClientBindPreferredPort pour configurer le port préféré de l'application et utiliser le transport de votre choix.
Pour configurer le mappage de port préféré à l'aide de l'outil wsadmin, procédez comme suit :
Procédure
Résultats
Exemple
$AdminApp install MultiEjbJar.ear {-WebServicesClientBindPreferredPort {{ejbclientonly.jar
Exchange service/StockQuoteService {http://stock.multiejbjar.test.wsfvt.ws.ibm.com}StockQuote
{http://stock.multiejbjar.test.wsfvt.ws.ibm.com}StockQuote}...}}
Les informations de type de port qui déterminent la création des données de l'option WebServicesClientBindPreferredPort se trouvent dans le fichier WSDL client. Comme les mappages de port préférés du client se limitent aux ports qui implémentent l'interface du type de port, la validation nécessite le type d'implémentation de chaque port. Le fichier WSDL client doit être accessible pour que les informations de type et d'implémentation puissent être déterminées.
Le nom du fichier WSDL est un attribut ServiceRef du descripteur de déploiement du client de services Web. Selon le type et la version du module, le descripteur de déploiement du client se trouve dans le fichier application-client.xml, le fichier web.xml ou le fichier ejb-jar.xml. Si vous utilisez J2EE 1.3, les informations sur le descripteur de déploiement se trouvent dans le fichier webservices.xml.