Commande createWSGWProxyService

La commande createWSGWProxyService permet de définir la passerelle de sorte qu'elle serve de proxy pour votre service et d'utiliser des gestionnaires JAX-RPC pour définir les noeuds finaux des messages de demande entrants destinés au service.

Vous pouvez créer une configuration de service proxy à l'aide l'outil wsadmin, comme décrit dans cette rubrique, ou de la console d'administration, comme décrit dans Création d'une configuration de service proxy.

Pour exécuter la commande, utilisez l'objet AdminTask du client de scriptage wsadmin.

[IBM i][IBM i]Le client de scriptage wsadmin est exécuté à partir de Qshell. [IBM i]Pour plus d'informations, voir Configuration de Qshell pour exécuter des scripts WebSphere à l'aide de l'outil de scriptage wsadmin.

L'aide de la ligne de commande est fournie pour les commandes de bus d'intégration de services :
  • Pour obtenir une liste des commandes de passerelle disponibles et une brève description de chacune d'elles, entrez la commande suivante à l'invite wsadmin :

    print AdminTask.help('WSGateway')

  • Pour obtenir une aide générale sur une commande donnée, entrez la commande suivante à l'invite wsadmin :

    print AdminTask.help('nom_commande')

Après avoir utilisé ces commandes, sauvegardez les modifications apportées à la configuration maîtresse en exécutant la commande suivante :

AdminConfig.save()

Rôle

Cette commande crée un objet ProxyService avec un objet InboundService associé et un objet TargetService avec un objet OutboundService associé.

Vous utilisez ensuite une commande des services Web activés par un bus d'intégration de services pour ajouter les objets InboundPort associés à l'objet InboundService. Pour plus d'informations, voir l'exemple pratique à la fin de cette rubrique.

Objet cible

ObjectName de l'instance de passerelle dans laquelle le service proxy est créé.

Cette commande crée la destination des demandes du proxy et la destination des réponses correspondante. La destination des demandes du proxy est configurée pour mettre à jour le chemin des réponses afin d'ajouter la destination des réponses du proxy. S'il existe déjà une destination portant le nom spécifié ou par défaut, la commande échoue.

S'il existe déjà un service de passerelle ou un service proxy de ce nom, la commande échoue.

Si vous spécifiez le nom de la destination des demandes du proxy, la destination du service proxy et les destinations de port sont créées à partir du nom de la destination des demandes du proxy. Sinon, la destination du service proxy et les destinations de port sont créées à partir du nom du service proxy. Le nom de la destination du service proxy est créé en ajoutant "ProxyService" au nom de la destination des demandes du proxy ou à celui du service proxy. Chaque destination de port de proxy est ensuite nommée à partir du nom de la destination du service proxy, auquel sont ajoutés un signe deux-points (":"), le nom du port et "Port". S'il existe déjà une destination portant l'un de ces noms, la commande échoue.

Indiquez le noeud et le serveur ou indiquez le cluster. Si aucun moteur de messagerie n'est défini pour le noeud et le serveur ou le cluster spécifiés, la commande n'aboutit pas.

La commande crée un objet OutboundService de même nom que le service proxy. Ce nouveau service de communications sortantes utilise les destinations créées, l'emplacement fourni et l'emplacement du WSDL du proxy par défaut de l'instance de passerelle ou, s'il est spécifié, l'emplacement du fichier WSDL du proxy. Le nouveau service de communications sortantes est associé à l'objet ProxyService.

Le WSDL du proxy ne doit contenir qu'un élément de service. S'il existe plusieurs ports dans cet élément de service, un objet de port de communications sortantes est créé pour chacun d'eux.

Le fichier WSDL du proxy ne devant jamais provenir du registre UDDI, seule les adresses Web sont prises en charge pour l'emplacement du fichier WSDL du proxy par défaut et celui du fichier du proxy WSDL remplacé.

La commande utilise la destination du proxy pour créer un objet InboundService de même nom que le service proxy et utilise l'emplacement du WSDL du proxy par défaut ou spécifié comme emplacement du modèle du WSDL.

Paramètres requis

-name
Nom du service proxy.

Paramètres conditionnels

-node
Noeud sur lequel se trouvent les destinations.
-server
Serveur sur lequel se trouvent les destinations.
-cluster
Cluster dans lequel se trouvent les destinations.

Paramètres optionnels

-requestDestination
Nom de la destination des demandes du proxy.
-replyDestination
Nom de la destination des réponses du proxy.
-wsdlLocation
Emplacement du fichier WSDL du proxy. Il s'agit d'une adresse Web.

Exemple

Vous trouverez c-après le plus petit exemple de séquence de commandes permettant de créer un service proxy complet associé à des communications entrantes et sortantes par le protocole SOAP sur HTTP :
  1. Créez le service proxy, wsgw correspondant à l'instance de passerelle :
    • Avec Jython :
      proxyService = AdminTask.createWSGWProxyService(wsgw, ["-name",
       "MyProxyService", "-node", "MyNode", "-server", "server1"])
    • Avec Jacl :
      set proxyService [$AdminTask createWSGWProxyService $wsgw {-name "ProxyService" -node "MyNode" -server "server1"}]
  2. Extrayez le service de communications entrantes du service de passerelle, nomBus correspondant au nom du bus d'intégration de services :
    • Avec Jython :
      inServiceName = AdminConfig.showAttribute(proxyService, 
       "inboundServiceName")
      inService = AdminConfig.getid("/SIBus:"+nomBus+"/SIBWSInboundService:"+inServiceName+"/")
    • Avec Jacl :
      set inServiceName [$AdminConfig showAttribute $proxyService
       "inboundServiceName"]
      set inService [$AdminConfig getid /SIBus:$nomBus/SIBWSInboundService:$inServiceName/]
  3. Ajoutez un port SOAP sur HTTP, sur lequel le programme d'écoute de noeud final SOAP sur HTTP 1 est déjà configuré :
    • Avec Jython :
      inPort = AdminTask.addSIBWSInboundPort(inPort, ["-name", "SOAPHTTPPort",
       "-endpointListener", "soaphttp1", "-node", "MyNode", "-server", "server1"])
    • Avec Jacl :
      set inPort [$AdminTask addSIBWSInboundPort $inPort {-name "SOAPHTTPPort" -endpointListener "soaphttp1" -node "MyNode" -server "server1"}]
  4. Configurez les ports et les services de communications entrantes et sortantes. Par exemple, appliquez les gestionnaires JAX-RPC ou WS-Security.
Remarque :
Vérifiez que tous les demandeurs du service ajoutent un paramètre de chaîne de requête operationMode à la fin de l'adresse du service proxy. Ce paramètre a la valeur oneway ou requestResponse ; la valeur par défaut est requestResponse. Par exemple :
  • Pour l'opération HTTP, si l'adresse Web du service proxy est
    http://nom_hôte:numéro_port/wsgwsoaphttp1/soaphttpengine
    /votre_bus/ProxyService/ProxyServiceInboundPort
    les clients demandeurs indiquent qu'ils envoient une demande unilatérale à l'aide de l'URL suivante :
    http://nom_hôte:numéro_port/wsgwsoaphttp1/soaphttpengine
    /votre_bus/ProxyService/ProxyServiceInboundPort?operationMode=oneway
  • Pour l'opération JMS, si l'adresse JMS du service proxy est
    jms:/queue?destination=jndi_queue&connectionFactory=
    jndi_factory&targetService=votre_bus/ProxyService/ProxyServiceInboundPort
    les clients demandeurs indiquent qu'ils envoient une demande unilatérale à l'aide de l'URL suivante :
    jms:/queue?destination=jndi_queue&connectionFactory=
    jndi_factory&targetService=
    your_bus/ProxyService/ProxyServiceInboundPort&operationMode=oneway

Icône indiquant le type de rubrique Rubrique de référence



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=rwsg_cli_proxy_new
Nom du fichier : rwsg_cli_proxy_new.html