Vue d’ensemble de l’adaptateur
L’adaptateur webMethods pour JMS est un complément au serveur d’intégration webMethods qui vous permet d’échanger des messages avec les fournisseurs JMS grâce à l’utilisation des API JMS.
L’adaptateur fournit une communication transparente et en temps réel avec les fournisseurs JMS.
À l’aide de l’Adaptateur pour JMS, les clients webMethods peuvent créer et exécuter des services qui peuvent échanger des messages à partir de files d’attente et de sujets sur le pro JMS.
Architecture et composants
L’Adaptateur pour JMS vous permet de configurer les composants suivants :
- Connexions Adaptateur : Activez la suite de produits WebMethods pour vous connecter aux fournisseurs JMS au moment de l’exécution.
- Services d’adaptateur : Effectuez des opérations sur les fournisseurs de JMS à l’aide des services intégrés fournis avec l’adaptateur pour JMS.
- Notifications MessageListener: Fournir une notification asynchrone des messages dans les files d’attente et les sujets.
Le diagramme suivant illustre comment l’Adaptateur pour JMS s’interface avec un fournisseur JMS à l’aide d’API JMS.
Après le diagramme, sont des descriptions des différentes pièces architecturales impliquées dans le processus d’intégration.
webMethods Integration Server : L’Adaptateur pour JMS est installé et fonctionne sur le serveur d’intégration.
WmART Package : Le package WmART fournit un cadre commun pour la suite de produits webMethods 6.x et les adaptateurs ultérieurs pour utiliser la fonctionnalité du serveur d’intégration, faisant du serveur d’intégration l’environnement de temps d’exécution pour l’adaptateur pour JMS. Le paquet WmART est installé avec le serveur d’intégration.
Adapter for JMS : L’Adaptateur pour JMS est livré sous forme d’un seul paquet appelé WmJMSAdapter. L’Adaptateur pour JMS fournit des interfaces utilisateur d’administrateur de serveur d’intégration et de développeur ou de concepteur qui vous permettent de configurer et de gérer les connexions adaptateurs, les services d’adaptateur et les notifications d’adaptateur.
Adapter Connection Templates : Les connexions adaptateurs permettent à l’Adaptateur pour JMS de se connecter aux fournisseurs JMS. Vous devez configurer une connexion d’adaptateur avant de pouvoir configurer des services d’adaptateur ou des notifications d’adaptateur. L’Adaptateur pour les connexions de JMS utilise JNDI pour rechercher les usines de connexion JMS.
Adapter Service Templates : Les services d’adaptateur permettent à l’Adaptateur pour JMS de produire et de consommer des messages à partir de destinations JMS (files d’attente et sujets). L’Adaptateur pour JMS fournit des modèles de service d’adaptateur qui vous permettent de configurer les services d’adaptateur. L’Adaptateur pour les services de JMS utilise JNDI pour rechercher les destinations JMS.
Adapter Notification Template : Les notifications adaptateurs permettent à l’Adaptateur pour JMS d’écouter et de récupérer des messages à partir de destinations JMS (files d’attente et sujets). L’Adaptateur pour JMS fournit un modèle de notification d’adaptateur qui vous permet de configurer les notifications d’adaptateur. L’Adaptateur pour les notifications de JMS utilise JNDI pour rechercher les destinations JMS.
JMS APIs : L’Adaptateur pour JMS utilise des API JMS pour interagir avec le fournisseur JMS.
JMS Provider : L’adaptateur pour les services et notifications JMS est associé à des destinations JMS spécifiques (files d’attente ou sujets) dans le fournisseur JMS. L’Adaptateur pour JMS peut récupérer des objets configurés de la classe ConnectionFactory et Destination à partir d’un service de nommage pris en charge par JNDI. L’Adaptateur pour JMS ne dicte pas la façon dont un fournisseur JMS devrait publier des entités d’usine de connexion et de destination de message. Toutefois, il ne prend en charge que les fournisseurs JMS qui publient ces objets dans un service de nommage soutenu par JNDI. Pour configurer des objets de ces classes et les enregistrer dans un service de nommage JNDI, vous devez utiliser les outils administratifs fournis par votre fournisseur JMS. La classe ConnectionFactory expose les méthodes qui permettent à une application JMS d’établir des connexions au système de messagerie sous-jacent.
Les objets de classe destination identifient :
- Topics : Une demande peut publier un sujet ou s’y abonner.
- Queues : Une application peut envoyer des messages à une file d’attente ou recevoir des messages.
Connexions d’adaptateur
L’Adaptateur pour JMS utilise des connexions d’adaptateur pour définir comment ses services d’adaptateur et ses notifications d’adaptateur se connectent aux fournisseurs JMS. Chaque adaptateur pour la connexion JMS contient un ensemble de paramètres de connexion, y compris les paramètres logon dont l’adaptateur a besoin pour se connecter au fournisseur JMS. Vous devez configurer une connexion d’adaptateur avant de pouvoir configurer un service d’adaptateur.
L’Adaptateur pour JMS a deux types de connexions :
- Adaptateur pour JMS QueueConnection : Sélectionnez ce type de connexion pour vous connecter à une file d’attente.
- Adaptateur pour JMS TopicConnection : Sélectionnez ce type de connexion pour vous connecter à un sujet.
Gestion des transactions adaptateur pour JMS Connections
L’Adaptateur pour les connexions JMS prend en charge les types de transactions suivants :
XA_TRANSACTION : Ce type de transaction permet à la connexion de prendre en charge les transactions en deux phases exécutées sur plusieurs ressources. Dans une limite de transaction, toutes les opérations sur plusieurs connexions seront engagées ou annulées. Une limite de transaction signifie la portée de la transaction, du début à la fin d’une transaction. Il peut être dans un service d’adaptateur, un service de flux, un service Java, ou plusieurs étapes dans un service de flux.
NO_TRANSACTION : Lors de la réception des messages, la connexion reconnaît automatiquement le message reçu (les sessions sont créées avec le mode CLIENT_ACKNOWLEDGE). Lors de l’envoi de messages, le message est automatiquement livré.
LOCAL_TRANSACTION : La connexion ne s’engage pas automatiquement à des transactions. Vous pouvez définir manuellement les transactions, ou le gestionnaire de transactions Integration Server la gérera pour vous.
Notifications d’adaptateur
L’Adaptateur pour JMS fournit une notification appelée MessageListener, qui surveille une destination JMS spécifiée (file d’attente ou sujet) et avise l’adaptateur lorsqu’un message arrive à cette destination.
Vous pouvez configurer la notification pour publier le document publiable associé à la notification ou configurer la notification pour invoquer un flux ou un service Java à l’aide des données de la notification.
Si la notification publie le document, vous pouvez utiliser un déclencheur de serveur d’intégration pour surveiller un document publiable donné associé à une notification.
Lorsque Integration Server reçoit ce document publiable, il invoque un flux ou un service Java qui est enregistré avec le déclencheur. Le flux ou le service Java réagit ensuite aux modifications de données contenues dans le document publiable de la notification.
Pour plus de détails sur les documents publiables de Integration Server, consultez le guide du développeur de publication du serveur d’intégration pour votre version.
Voir « A propos de ce guide » pour les titres de documents spécifiques.
