Pour pouvoir déployer des applications de messagerie qui utilisent Java™ Messaging Service (JMS), vous devez ajouter les dispositifs wasJmsServer-1.0 et wasJmsClient-2.0 au fichier server.xml et définir les propriétés de fabrique de connexions et de destination. Si vous voulez effectuer une recherche JNDI, vous devez ajouter le dispositif jndi-1.0 en plus des deux autres.
Avant de commencer
Assurez-vous d'avoir créé un serveur Liberty sur lequel déployer l'application de messagerie qui utilise le service JMS. Pour plus d'informations, voir Création manuelle d'un serveur Liberty.
Important : wasJmsClient-2.0La fonction
prend en charge les fonctions des spécifications JMS 1.1 et JMS 2.0. Toutefois, vous pouvez choisir d'utiliser la fonction
wasJmsClient-1.1
si vous voulez utiliser uniquement les fonctions qui sont conformes à
la spécification JMS 1.1.
Pourquoi et quand exécuter cette tâche
La fonction
wasJmsServer-1.0 prend en charge les applications qui utilisent les spécifications Java Messaging Service 1.1.
Procédure
- Ajoutez les dispositifs wasJmsServer-1.0, wasJmsClient-2.0 et jndi-1.0 au fichier server.xml.
<featureManager>
<feature>wasJmsServer-1.0</feature>
<feature>wasJmsClient-2.0</feature>
<feature>jndi-1.0</feature>
</featureManager>
- Ajoutez les définitions de destination au fichier server.xml.
<messagingEngine>
<queue id="QUEUE1"> </queue>
</messagingEngine>
- Facultatif : Ajoutez l'élément <wasJmsEndpoint>
afin de permettre au moteur de messagerie JMS d'accepter les connexions de messagerie entrantes distantes depuis TCP/IP (avec et sans SSL).
<wasJmsEndpoint
host="*"
wasJmsPort="7276"
wasJmsSSLPort="9100">
</wasJmsEndpoint>
Remarque : L'ajout de <wasJmsEndpoint> est
optionnel. Par défaut, le serveur Liberty permet au moteur de messagerie
d'être à l'écoute sur le port 7276 (non sécurisé) et le port 7286 (sécurisé). Si vous voulez spécifier un autre port, configurez
<wasJmsEndpoint>.
- Ajoutez les définitions de fabrique de connexion au fichier server.xml.
- Pour le domaine point-à-point :
<jmsQueueConnectionFactory jndiName="jndi_JMS_BASE_QCF">
<properties.wasJms
remoteServerAddress="localhost:7276:BootStrapBasicMessaging" />
</jmsQueueConnectionFactory>
<jmsQueue jndiName="jndi_INPUT_Q">
<properties.wasJms queueName="QUEUE1" />
</jmsQueue>
- Pour le domaine publication/abonnement :
<jmsTopicConnectionFactory jndiName="eis/tcf">
<properties.wasJms
clientID="defaultID" />
</jmsTopicConnectionFactory>
<jmsTopic jndiName="eis/topic1">
<properties.wasJms topicName="Football" />
</jmsTopic>
Les applications JMS sont désormais connectées au serveur de messagerie imbriquée.