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

  1. Lancez une commande de script. Pour plus d'informations, voir Démarrage du client de scriptage wsadmin.
  2. Configurez les mappages de port préférés d'un client de services Web.

    Pour utiliser le port d'écoute existant au lieu d'utiliser ou de créer une spécification d'activation, déterminez si la version JAR d'EJB est inférieure à 2.1. Le système crée et utilise automatiquement une spécification d'activation que vous spécifiez à l'aide de l'option -usedefaultbindings pour déployer une application. Si une spécification d'activation existe, le système ignore le port d'écoute, mais utilise la spécification d'activation. Pour déployer une application avec une version JAR d'EJB supérieure ou égale à 2.1 utilisant les ports d'écoute définis au lieu d'une nouvelle spécification d'activation, attribuez la valeur true à la propriété système com.ibm.websphere.management.application.dfltbndng.mdb.preferexisting dans le fichier wsadmin.properties figurant dans le répertoire des propriétés du profil concerné.

    Utilisez les options install, installInteractive, edit ou editInteractive pour configurer les mappages de port préférés d'un client de services Web, comme la syntaxe suivante le décrit :

    • En langage Jython :
      AdminApp.install('nom_app', '[-usedefaultbindings -deployejb 
      -WebServicesClientBindPreferredPort {{nom_module nom_EJB service_Web type_port 
      nom_port]')
    • A l'aide de Jacl :
      $AdminApp install nom_app {-usedefaultbindings -deployejb 
      -WebServicesClientBindPreferredPort {{nom_module nom_EJB service_Web type_port 
      nom_port}}
    L'exemple mentionne plusieurs modules et noeuds finals d'URL car vous pouvez modifier plusieurs fragments d'URL où :
    • nom_app est le nom de l'application (par exemple, MultiEjbJar.ear).
    • nom_EJB est le nom du module de bean enterprise et non un module Web (par exemple, Exchange).
    • nom_module est le nom du module (par exemple, ejbclientonly.jar).
    • service_Web est le nom du service Web (par exemple, service/StockQuoteService).
    • type_port définit le type du port (par exemple {http://stock.multiejbjar.test.wsfvt.ws.ibm.com}StockQuote).
    • nom_port définit le nom du port (par exemple {http://stock.multiejbjar.test.wsfvt.ws.ibm.com}StockQuote).

Résultats

Vous avez configuré les mappages de port préférés du client de services Web à l'aide de l'outil wsadmin.

Exemple

L'exemple suivant inclut l'application, le module, le service Web, le type de port et les informations de port tels qu'ils figurent dans la ligne de commande :
$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.

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_preferredportwsadmin
Nom du fichier : txml_preferredportwsadmin.html