Création d'une configuration de service proxy

Vous pouvez définir la passerelle de services Web pour qu'elle fasse office de proxy pour le service, puis utiliser les listes de gestionnaires JAX-RPC pour définir les noeuds finaux des messages de demande entrants destinés du service.

Avant de commencer

Pour une vue générale de la méthode de configuration de la passerelle des services Web dans le cadre d'une configuration globale des services Web activés par un bus d'intégration de services, voir Activation des services Web via le bus d'intégration de services.

Comme vous configurez chaque service proxy pour une instance de passerelle spécifique, vous devez créer l'instance de passerelle avant de configurer des services proxy pour elle.

Déterminez la méthode à utiliser pour configurer ces ressources. Vous pouvez créer un service proxy à l'aide de la console d'administration, comme décrit dans cette tâche, ou à l'aide de la Commande createWSGWProxyService.

Pourquoi et quand exécuter cette tâche

Lorsque vous créez une configuration de service proxy, la passerelle ne fait qu'appeler ce service. Lorsque vous configurez un service proxy, vous configurez également une liste de gestionnaires JAX-RPC qui utilise javax.xml.rpc.service.endpoint.address pour définir le noeud final cible du service. Vous associez ensuite la liste de gestionnaires au port de communications entrantes du service proxy.

Une configuration de service proxy ne possède pas de services cible et donc aucun WSDL que la passerelle peut utiliser pour configurer l'appel du service. Un fichier WSDL de proxy générique est utilisé pour configurer les paramètres de base de cet appel (par exemple, la liaison à utiliser), mais vous pouvez remplacer les paramètres par défaut en fournissant votre propre fichier WSDL de proxy générique équivalent. Si la liste des gestionnaires JAX-RPC n'est pas déployée, la passerelle tente d'envoyer toutes les demandes à la fausse adresse Web spécifiée dans la balise <soap:target address> du fichier WSDL de proxy.

Pour plus d'informations, voir Gestionnaires JAX-RPC et fonctionnement du proxy.

Pour créer une configuration de service proxy à l'aide de la console d'administration, procédez comme suit :

Procédure

  1. Créez un gestionnaire JAX-RPC qui utilise javax.xml.rpc.service.endpoint.address pour définir le noeud final cible du service. C'est à vous de décider comment vous souhaitez établir le noeud final cible, et de créer et configurer le gestionnaire JAX-RPC javax.xml.rpc.service.endpoint.address.
  2. Créez une configuration de gestionnaire JAX-RPC pour le gestionnaire qui définit le noeud final cible de ce service.
  3. Créez une liste de gestionnaires JAX-RPC, sélectionnez le gestionnaire qui définit le noeud final cible de ce service, puis ajoutez-le à la liste de gestionnaires.
  4. Démarrez la console d'administration.
  5. Dans le panneau de navigation, cliquez sur Intégration des services -> Bus -> nom_bus -> [Propriétés supplémentaires] Instances de la passerelle de services Web -> nom_instance -> Services proxy Le formulaire de collecte des services proxy est affiché.
  6. Cliquez sur Nouveau. L'assistant Nouveau service proxy est affiché.
  7. A l'aide de l'assistant, créez une configuration de service proxy en effectuant la procédure ci-après. Pour plus d'informations sur les propriétés définies à l'aide de l'assistant, voir Paramètres des services proxy.
    1. Spécifiez le nom du service proxy, le point du port du proxy, les destinations du service et les médiations.
      Remarque :
      • Choisissez un nom de service proxy qui n'existe pas déjà sur les services de passerelle et proxy de l'instance de passerelle actuelle. Si vous entrez un nom existant, un message d'erreur est affiché.
      • Le point du port du proxy correspond au point où la destination du port du proxy doit se trouver.
      • Vous n'avez pas besoin de fournir les noms des destinations du proxy. Si vous ne renseignez pas l'une de ces zones, un nom par défaut est généré une fois que l'assistant à terminer son travail. Les noms par défaut ne sont pas affichés dans le panneau. Ils sont créés de la manière suivante :
        • Le nom de la destination des demandes correspond au nom du service proxy. Par exemple : monServiceProxy.
        • Le nom de la destination des réponses correspond au nom de la destination des demandes, suivi de "Réponse". Par exemple : monServiceProxyRéponse.
      • Les listes des médiations disponibles contiennent toutes les médiations actuellement déployées sur ce bus d'intégration de services. Si vous avez créé une médiation et que vous l'avez déployée sur le bus, elle peut être sélectionnée dans ces deux listes. Si vous ne voulez pas utiliser de médiation avec ce service proxy, sélectionnez aucune dans l'une des listes de sélection.
      • Les membre de bus sont des serveurs d'applications ou des clusters qui sont ajoutés à ce bus. Les propriétés Membre du bus de médiation des demandes et Membre du bus de médiation des réponses définissent les membres de bus auxquels la médiation correspondante est affectée. Si vous sélectionnez une médiation, vous devez l'attribuer à un membre de bus ; si vous remplacez la valeur des propriétés Médiation de demande ou Médiation de réponse par (none), vous devez également remplacer la valeur de la propriété du membre de bus correspondant par (none).

        Si vous ne le faites pas, la console d'administration affiche un message d'erreur.

      • Un fichier WSDL de proxy générique est utilisé pour configurer les paramètres de base de cet appel (par exemple, la liaison à utiliser), mais vous pouvez remplacer les paramètres par défaut en saisissant l'emplacement de votre fichier WSDL générique de remplacement dans la zone URL de remplacement de WSDL de proxy.
    2. Sélectionnez des modules d'écoute de noeud final pour la configuration des communications entrantes de ce service proxy.
  8. Cliquez sur Terminer.

Résultats

Si le traitement se déroule correctement, la liste des services proxy de cette instance de passerelle est mise à jour pour inclure le nouveau service proxy. Sinon, un message d'erreur s'affiche.

Que faire ensuite

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