network : antoine.guiral.info bertrand.guiral.info

JMS: Un exemple vraiment simple

2 mai 2008 par admin

Catégorie: tutoriels

JMS : Java Messaging Service

L’API JMS est une API de messagerie qui permet à des applications de créer, envoyer, recevoir et lire des messages. C’est un système de communication distribué, faiblement lié (”loosely coupled”), fiable et asynchrone.

C’est une norme.

C’est un des piliers de J2EE.

Je propose un exemple ultra-simple, permettant de se familiariser avec cette API.
Je ne fait pas appel volontairement à JNDI, ce qui limite la portée de JMS à une seule application: cela suffit parfois (et j’aime cette idée de juste suffisant), et cela permet de se familiariser avec cette API.

Il faut une implémentation de la l’API jms : Sun propose un produit … gratuit: Sun Java System Message Queue 3 2005Q1 Platform Edition.
Après l’avoir télécharger, il faut mettre jms.jar et imq.jar dans le classpath de notre exemple.

Voilà le fichier source SimpleQueueSender.java (A mettre donc dans les répertoires bg/testJms/):

  1.  
  2. package bg.testJms;
  3.  
  4. import javax.jms.QueueConnectionFactory;
  5. import javax.jms.QueueConnection;
  6. import javax.jms.QueueSession;
  7. import javax.jms.QueueSender;
  8. import javax.jms.QueueReceiver;
  9. import javax.jms.Queue;
  10. import javax.jms.Session;
  11. import javax.jms.Message;
  12. import javax.jms.TextMessage;
  13.  
  14. public class SimpleQueueSender {
  15.  
  16.     private static int nbMessagesTest = 5;
  17.  
  18.     public static void main(String[] args) throws Exception {
  19.  
  20.         QueueConnectionFactory myQConnFactory = new com.sun.messaging.QueueConnectionFactory();
  21.         QueueConnection myQConn = myQConnFactory.createQueueConnection();
  22.         QueueSession myQSess = myQConn.createQueueSession(false, Session.AUTO_ACKNOWLEDGE);
  23.         Queue myQueue = new com.sun.messaging.Queue("world");
  24.         QueueSender myQueueSender = myQSess.createSender(myQueue);
  25.         for (int i = 0; i < nbMessagesTest; i++) {
  26.             TextMessage myTextMsg = myQSess.createTextMessage();
  27.             myTextMsg.setText("Hello World " + i);
  28.             System.out.println("Sending Message: " + myTextMsg.getText());
  29.             myQueueSender.send(myTextMsg);
  30.         }
  31.  
  32.         //envoyer un message de fin de session
  33.         myQueueSender.send(myQSess.createMessage());
  34.  
  35.         //
  36.         QueueReceiver myQueueReceiver = myQSess.createReceiver(myQueue);
  37.         myQConn.start();
  38.         Message msg;
  39.         boolean isOn = true;
  40.         int j=0;
  41.         while (isOn) {
  42.             j++;
  43.             msg = myQueueReceiver.receive();
  44.             if (msg instanceof TextMessage) {
  45.                 TextMessage txtMsg = (TextMessage) msg;
  46.                 System.out.println("Read Message: " + txtMsg.getText());
  47.             }else {
  48.                 isOn = false;
  49.             }
  50.         }
  51.         System.out.println("byby");
  52.         myQSess.close();
  53.         myQConn.close();
  54.     }
  55. }

Quelques commentaires:

  1. QueueConnectionFactory, QueueConnection, QueueSession, QueueSender,QueueReceiver, Queue, Session, Message: appartiennent à l’API jms (Dans jms.jar dans notre cas) et sont des Interfaces. C’est la traduction de la norme jsr 914. Ce sont des javax (Lire java eXtension) , et donc des classes de base. (Elles sont dans jeejava.jar). elles ne sont cependant pas (Ou pas encore) cependant dans la JRE de base.
    com.sun.messaging.QueueConnectionFactory est une implémentation de l’API Jms. Elle est livrée dans un autre jar (imq.jar dans notre exemple). Il existe de nombreuses implémentations (Certaines libre, d’autre payantes ….) de l’API jms.
  2. Le principe à retenir est le suivant: Un message est écrit dans une queue, et il est lu une seule fois à un autre rythme par un seul destinataire.
    Par exemple vous voulez réaliser une fonction qui prend du temps (Faire un transfert ftp, envoyer un mail à un serveur smtp, commiter des données dans une base de donnée …) vous un envoyé un message par jms, et la tache est réalisée quand le client destinataire est disponible .
  3. L’inconvénient sur cet exemple, c’est que l’envoyeur et le destinataire doivent s’exécuter dans la même JRE et doivent partager une référence commune.Ouep ! Pas très réparti! Un peu limité!
    Attendez de découvrir JNDI! Un prochain tuto peut être….

  4. Nous avons vu sur notre exemple un communication dit Point To Point. Il existe un autre mode de communication (publish/souscribe) où les consommateurs s’abonne à un sujet (topic) et ou l’émetteur ne connait pas les destinataires. Essayer de le trouver tout seul!

Ce tutoriel vous a aidé?

Promouvoir cet article : Ces icônes sont des liens vers des sites de partage de signet sociaux où les lecteurs peuvent partager et découvrir de nouveaux liens.
  • Digg
  • del.icio.us
  • Facebook
  • Mixx
  • Google
  • blogmarks
  • BlogMemes
  • co.mments
  • e-mail
  • Live
  • Ma.gnolia
  • Scoopeo
  • Technorati
  • Wikio FR

Laissez un commentaire