Configurer le fournisseur JMS

La prise en charge de JMS pour Apache ActiveMQ est préconfigurée dans FME Form; ; aucune configuration supplémentaire n'est requise. Pour une référence complète, voir JNDI Support. (JMS utilise l'interface Java Naming and Directory (JNDI) pour demander dynamiquement des objets nommés au courtier de messages).

Lors de l'utilisation d'Apache ActiveMQ avec JMS, se souvenir de ceci :

• FME Form se connecte à ActiveMQ via le connecteur de transport spécifié dans le fichier de configuration XML du courtier de messages. Par défaut, l'URL est tcp://hostname:61616.

• FME Form, en tant que client JMS, se connecte à ActiveMQ par l'intermédiaire d'un objet nommé usine de connexion, et référence les sujets ou les files d'attente ActiveMQ par l'intermédiaire d'un objet nommé destination. Les objets nommés sont généralement spécifiés via un fichier de configuration JNDI, jndi.properties. Pour plus d'informations, voir JNDI Support.

• Dans la configuration la plus simple, un fichier jndi.properties n'est pas nécessaire. Par défaut, le nom de l'usine de connexion est ConnectionFactory. ActiveMQ fournit également un moyen de se connecter dynamiquement aux files d'attente et aux sujets via les noms de destination spéciaux dynamicQueues/<queue> et dynamicTopics/<topic>.

Pour IBM WebSphere 7, un ensemble d'objets administrés JMS doit être créé afin d'assurer l'interface avec JMS. Le moyen le plus simple d'accomplir cette tâche est d'utiliser MQ Explorer.

Les étapes suivantes supposent qu'une file d'attente de messages est déployée et fonctionne sur un serveur, et qu'un canal de connexion au serveur est créé pour les connexions client. Dans nos exemples, le nom du gestionnaire de file d'attente est qm, le nom d'hôte du serveur du gestionnaire de file d'attente est server et le nom du canal de connexion au serveur est c1.

1. Installer et lancer MQ Explorer sur la machine avec l'installation de FME Form.
2. Ajouter une connexion au gestionnaire de file d'attente désiré.

1. Dans la barre de navigation sur la gauche, clic droit sur Gestionnaires de file d'attente et sélectionner Ajouter un gestionnaire de file d'attente distant.
2. Dans l'assistant, préciser les paramètres suivants :

Nom du gestionnaire de file d'attente	qm (par exemple)
Méthode de connexion	Connecter directement
Nom de l'hôte ou adresse IP	server (par exemple)
Numéro de port	1414
Chaîne de connexion au serveur	SYSTEM.ADMIN.SVRCONN (par exemple)

3. S'assurer que la chaîne de connexion au serveur spécifiée (par défaut : SYSTEM.ADMIN.SVRCONN) et un écouteur pour le port TCP spécifié (par défaut : LISTENER.TCP) sont activés.
4. Sélectionnez Terminer pour clore l'assistant. Une nouvelle connexion à un gestionnaire de file d'attente distant devrait apparaître.

3. Créer un contexte initial JMS

1. Dans la barre de navigation sur la gauche, clic droit sur Objets administrés JMS et sélectionner Ajouter un contexte initial.
2. Dans l'assistant, préciser les paramètres suivants :

Localisation de l'espace de nommage JNDI	Système de fichiers
Répertoire	c:\jndi (par exemple)
URL du fournisseur	file:/C:/jndi/ (par exemple)

3. Sélectionnez "Terminer" pour clore l'assistant. Un nouveau contexte initial devrait apparaître.

4. Créer une fabrique de connexions JMS.

1. Clic droit sur Fabrique de connexions dans le nouveau contexte initial créé et sélectionner Nouveau / Fabrique de connexions.
2. Dans l'assistant, préciser les paramètres suivants :

Nom	cf1 (par exemple)
Fournisseur du message	WebSphere MQ
Méthode	ConnectionFactory (Fabrique de connexions)
Transport	Client MQ
Gestionnaire de connexion/de file d'attente de base	qm (par exemple)
Liste de connexion/Connexion	server(1414) (par exemple)
Chaîne/Chaîne	c1 (par exemple)

3. S'assurer que le gestionnaire de file d'attente et les paramètres de connexion correspondent à ceux du gestionnaire de file d'attente spécifié ci-dessus.
4. Sélectionnez Terminer pour clore l'assistant. Les nouvelles connexions apparaissent.

5. Créer une destination JMS pour chaque sujet ou file d'attente désiré.

1. Sélectionner Files d'attente ou Sujet sous le gestionnaire de file d'attente pour faire revenir la liste actuelle des files d'attente ou sujets.
2. Clic droit sur la file d'attente ou le sujet désiré et sélectionner Créer une file d'attente JMS ou Créer un sujet JMS.
3. Dans l'assistant, donner un nom à l'objet JMS (q1 ou t1, par exemple).
4. Sélectionnez Terminer pour clore l'assistant. La nouvelle destination apparaît sous Destinations pour le contexte initial JMS.

6. Configurez la sécurité si nécessaire, en utilisant l'outil setmqaut. Par exemple, pour activer l'accès à un gestionnaire de file d'attente, exécutez la commande suivante :

setmqaut -m qm -t qmgr -g Users +inq +connect

Pour autoriser l'accès producteur à une file d'attente ou un sujet à un groupe particulier d'utilisateurs appelé Users, exécuter la commande suivante :

setmqaut -m qm -t queue -n q1 -g Users +get +inq +browse

setmqaut -m qm -t topic -n t1 -g Users +sub

Pour autoriser l'accès producteur à une file d'attente ou un sujet à un groupe particulier d'utilisateurs appelé Users, exécuter la commande suivante :

setmqaut -m qm -t queue -n q1 -g Users +put

setmqaut -m qm -t topic -n q1 -g Users +pub

1. Créer une file d'attente JMS dans le serveur Weblogic, en utilisant l'exemple souligné dans https://blogs.oracle.com/soaproactive/entry/how_to_create_a_simple.