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.
Le client de scriptage wsadmin est exécuté à partir de Qshell.
Pour plus d'informations, voir Configuration de Qshell pour exécuter des scripts WebSphere à l'aide de l'outil de scriptage wsadmin.
- 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')
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
- 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"}]
- Avec Jython :
- 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/]
- Avec Jython :
- 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"}]
- Avec Jython :
- Configurez les ports et les services de communications entrantes et sortantes. Par exemple, appliquez les gestionnaires JAX-RPC ou WS-Security.
- Pour l'opération HTTP, si l'adresse Web du service proxy est
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
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
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=votre_bus/ProxyService/ProxyServiceInboundPort
jms:/queue?destination=jndi_queue&connectionFactory= jndi_factory&targetService= your_bus/ProxyService/ProxyServiceInboundPort&operationMode=oneway