Utilisation du protocole de transfert HTTP avec Message Broker

Cette section explique comment échanger des documents entre WebSphere Partner Gateway et WebSphere Business Integration Message Broker via le protocole de transfert HTTP.

Remarque : Toutes les références relatives au protocole de transfert HTTP s'appliquent également au protocole HTTPS.

Composants requis pour les documents envoyés sur HTTP

Vous n'avez besoin d'aucun logiciel supplémentaire pour échanger un document entre WebSphere Partner Gateway et Message Broker via le protocole de transfert HTTP. Seuls WebSphere Partner Gateway et Message Broker sont requis. Pour que WebSphere Partner Gateway communique avec la version 5.0 de Message Broker via le protocole de transfert HTTP, ces deux composants doivent être configurés. Le tableau 65 récapitule ces étapes de configuration.

Tableau 65. Configuration de WebSphere Partner Gateway et de Message Broker
Composant Version Pour plus d'informations
WebSphere Partner Gateway 6.0

Configuration pour l'envoi de documents via le protocole de transfert HTTP

Configuration de documents entrants sur le protocole de transfert HTTP

WebSphere Business Integration Message Broker 5.0 Configuration de Message Broker

En outre, pour échanger un document entre WebSphere Partner Gateway et Message Broker via le protocole de transfert HTTP, vous devez utiliser la version 5.3 d'IBM WebSphere MQ comme fournisseur JMS.

Envoi de documents sur HTTP

Pour que WebSphere Partner Gateway envoie un document à Message Broker via le protocole de transfert HTTP, utilisez des noeuds de transfert HTTP spéciaux dans le flux de messages Message Broker afin de récupérer le document qui a été envoyé par WebSphere Partner Gateway sous la forme d'un flux HTTP. Les noeuds du flux de messages effectuent les calculs requis et acheminent ensuite le document vers une certaine destination (file d'attente de sortie JMS).

Les étapes suivantes expliquent comment WebSphere Partner Gateway envoie un document à un flux de messages dans Message Broker via le protocole de transfert HTTP :

  1. WebSphere Partner Gateway envoie un message HTTP à Message Broker.

    Si le type de regroupement du document était l'intégration dorsale, WebSphere Partner Gateway a intégré des propriétés personnalisées dans ce message.

    Remarque : Dans WebSphere Partner Gateway, vous devez configurer une passerelle qui identifie l'adresse URL à laquelle WebSphere Partner Gateway envoie le message et dans laquelle Message Broker effectue des interrogations. Pour plus d'informations, voir Configuration pour l'envoi de documents via le protocole de transfert HTTP.
  2. Le noeud HTTPInput du flux de messages récupère le document et l'envoie au noeud suivant du flux de messages. Ce noeud est généralement un noeud de calcul.
  3. Les noeuds du flux de messages exécutent la logique applicative.

    Une fois la logique applicative est terminée, le flux de messages envoie le document résultant à son noeud HTTPReply.

  4. Par défaut, le noeud HTTPReply renvoie le message de sortie au client (WebSphere Partner Gateway).

    Il se peut également que le flux de messages place le message dans un noeud MQOutput. Le noeud MQOutput reçoit le document et l'envoie à la file d'attente JMS appropriée ou à une autre application.

Réception de documents sur HTTP

Pour que WebSphere Partner Gateway reçoive un document de Message Broker via le protocole de transfert HTTP, utilisez des noeuds de transfert HTTP spéciaux dans le flux de messages Message Broker afin d'envoyer le document que WebSphere Partner Gateway doit recevoir sous la forme d'un flux HTTP. Les noeuds du flux de messages effectuent les calculs requis et traitent les interactions requête et réponse (s'il s'agit d'interactions synchrones) avec WebSphere Partner Gateway.

Les étapes suivantes expliquent comment WebSphere Partner Gateway reçoit un document à partir d'un flux de messages dans Message Broker via le protocole de transfert HTTP :

  1. Le flux de messages dans Message Broker reçoit un document dans son noeud MQInput (file d'attente d'entrée JMS).
  2. Le noeud MQInput du flux de messages reçoit le document et l'envoie au noeud HTTPRequest.
  3. Le noeud HTTPRequest traite les interactions requête et réponse avec le client (WebSphere Partner Gateway), à l'aide d'une adresse URL spécifiée.
  4. WebSphere Partner Gateway reçoit le message à partir de son adresse URL, telle qu'elle est configurée dans sa cible.

    Pour plus d'informations sur la cible, voir Configuration de documents entrants sur le protocole de transfert HTTP.

Création du flux de messages pour le transfert HTTP

Pour qu'un flux de messages Message Broker traite les documents via le protocole de transfert HTTP, il utilise les noeuds de transfert suivants :

L'ordre dans lequel ces noeuds de transfert sont utilisés est fonction du sens de la communication :

Tableau 66. Noeuds permettant l'envoi de documents à Message Broker via HTTP
Type de noeud Fonction Remarques
HTTPInput Reçoit le document de requête WebSphere Partner Gateway dans le flux de messages

Paramétrez la zone de sélection d'URL de ce noeud de transfert (dans les propriétés de base) sur l'adresse URL à laquelle WebSphere Partner Gateway envoie ses documents (adresse URL configurée dans la cible de WebSphere Partner Gateway). L'adresse URL doit être au format suivant :

http://nom_hôte:port/chemin

nom_hôte représente le nom de l'ordinateur sur lequel réside Message Broker, port le numéro du port HTTP sur lequel Message Broker est en mode écoute et chemin l'emplacement de cet ordinateur.

Pour plus d'informations, voir Configuration pour l'envoi de documents via le protocole de transfert HTTP.

Calcul Effectue des tâches de logique applicative, telles que la mise à jour des informations d'en-tête Utilisez ESQL pour effectuer la logique applicative. Le noeud de calcul envoie le message résultant au noeud HTTPReply.
HTTPReply Renvoie une réponse à WebSphere Partner Gateway Par défaut, ce noeud envoie le message de sortie au client. Cependant, vous pouvez le configurer pour l'envoyer à un noeud MQOutput.
MQOutput Reçoit le document du noeud HTTPReply et l'envoie à WebSphere Partner Gateway Ce noeud de transfert envoie le document résultant à une file d'attente de sortie JMS qui l'achemine vers sa prochaine destination.
Tableau 67. Noeuds permettant la réception de documents de Message Broker via HTTP
Type de noeud Fonction Remarques
MQInput Reçoit le document de WebSphere Partner Gateway Ce noeud de transfert reçoit le document entrant d'une file d'attente d'entrée JMS.
HTTPRequest Traite les interactions requête/réponse avec WebSphere Partner Gateway

Ce noeud de transfert doit paramétrer sa zone d'URL de services Web (dans les propriétés de base) en fonction de l'adresse URL sur laquelle WebSphere Partner Gateway est en mode écoute pour les documents (adresse URL configurée dans la cible de WebSphere Partner Gateway). L'adresse URL doit être au format suivant :

http://nom_hôte:port/bcgreceiver/chemin

nom_hôte représente le nom de l'ordinateur sur lequel réside WebSphere Partner Gateway, port le numéro du port HTTP sur lequel le récepteur de WebSphere Partner Gateway est en mode écoute et chemin l'emplacement de cet ordinateur.

Pour plus d'informations, voir Configuration de documents entrants sur le protocole de transfert HTTP.

Pour plus de détails sur la création et la configuration des noeuds de flux de messages, consultez la documentation WebSphere Business Integration Message Broker.

Copyright IBM Corp. 2003, 2005