JMS,MOM, MDB Java Message Service, Message-Oriented Middleware. Cnam Paris jean-michel Douin, douin au cnam point fr version 12 février 2013

Transcription

1 JMS,MOM, MDB Java Message Service, Message-Oriented Middleware Message-Driven Bean Cnam Paris jean-michel Douin, douin au cnam point fr version 12 février

2 Sommaire Objectifs Quelques patrons «MOM» issus de la bibliographie JMS une introduction La spécification JMS Un ensemble d interfaces Une implémentation «Open» OpenJMS MDB Message Driven Bean Une démonstration Un exemple basique avec OpenJMS 2

3 Bibliographie utilisée Le support de cours de NSY Tous les Patrons présentés sont extraits de, Gregor Hohpe and Bobby Woolf JMS : L indispensable tutoriel de Sun Architecture réparties en Java, de Annick Fron chez Dunod MDB 3

4 Style RPC-OO/Messaging, schémas d Uwe Zdun RPC-OO java-rmi.net remoting CORBA Messaging JMS* IBM WebSphere MQ Microsoft MSMQ * implementations de Java Message Service 4

5 Message-Oriented Middleware Objectifs Envoi et réception de messages Réceptions synchrone et asynchrone Modèles Point à point Publish-subscribe Fiabilité de la délivrance des messages Différents formats de messages Persistance souhaitable Indépendance des canaux de communication / applications Couplage faible assuré Les canaux de communications sont indépendants des applications Référence aux canaux plutôt qu aux adresses de machines Serveur JMS, un courtier 5

6 Modèles Point à point Plusieurs consommateurs peuvent attendre sur cette file, un seul seulement recevra ce message Publish/subscribe Plusieurs consommateurs peuvent attendre sur cette file, Tous les consommateurs recevront ce message 6

7 Exemples bien connus Le mail d internet Un émetteur envoie un message à un destinataire, Le récepteur reçoit ce message (sans action particulière), Les messages sont persistants, Point à Point, synchrone, asynchrone Les news d internet, ou le forum de jfod Enregistrement d un «client» à un sujet de discussion, Un des «clients» décide de poster un message, Les utilisateurs à leur initiative vont chercher l information, Publish-subscribe, mode pull Les listes de diffusion, logiciels de causerie, («chat») Abonnement d un «client» à une liste de diffusion, Un des «clients» décide de poster un message, Tous les abonnés reçoivent ce message, Publish-subscribe, mode push 7

8 Quelques patrons Patrons à l aide d un «langage graphique» de description d une architecture de type MOM Extraits de Et Mark grand MailBox, Retransmission, Connection Multiplexing, Publish-Subscribe, 8

9 Notation empruntée 9

10 MOM, Les patrons (65)!, selon Gregor Hohpe! 10

11 Message construction Request Reply Return Address Correlation Identifier 11

12 Patron Request-Reply Analogue à l architecture «Client/Serveur» Canaux de communications Point à point «Unidirectionnel» Séparation des requêtes et de la réponse 12

13 Patron Return Address Plusieurs clients/consommateurs Identification du consommateur, «receveur» Dans le contenu du message émis 13

14 Patron Correlation Identifier Le message contient un identificateur de Corrélation Un nombre unique permettant l identification et le bon acheminement du message Message ID GUID (Globally Unique ID) Business key (e.g. ID de bon de commande, de facture) Producteur copie l ID dans le message retourné Le client/consommateur peut ainsi corréler la requête et sa réponse 14

15 MessageConstruction, fin de l extrait Discussion Approche fonctionnelle informelle d un patron. La suite ici 15

16 Message channels Point à Point Publish Subscribe Observateur/Observé? Durable Subscriber Les bases de JMS 16

17 Point à point Envoi d un message sur un canal en point à point, Un seul receveur aura ce message La persistance peut être assurée Surtout si le récepteur n est pas en ligne lors de l émission Réception synchrone ou asynchrone Exemple déjà vu : le mail 17

18 Publish/Subscribe Observateur/Observé «sélectif» Souscription à un sujet/thème (topic) Publication sur ce thème entraîne le réveil des souscripteurs abonnés mode push Si l abonné est absent? Sélection de la souscription? En mode pull, les abonnés devront s enquérir des notifications 18

19 Durable Subscriber Durable Subscriber Sauvegarde/Persistance du message jusqu à ce que le souscripteur soit informé de la «publication» 19

20 Langage de description, à base de patrons MOM, possède les mêmes patrons! Message-oriented middleware (MOM) IBM WebSphere MQ Microsoft MSMQ Java Message Service (JMS) Implementations EAI Suites TIBCO, WebMethods, SeeBeyond, Vitria Asynchronous Web services Sun s Java API for XML Messaging (JAXM) Microsoft s Web Services Extensions (WSE) 20

21 Conclusion intermédiaire Transparents extraits de À lire donc 21

22 JMS, Java Message Service N est qu une spécification Soit en java Un ensemble d interfaces que tout fournisseur est tenu de respecter Une série de tests de «conformité» Comment? «Patron fabrique» Proposés par les fournisseurs JMS Exemple : ConnectionFactory fabrique = contexte.lookup("connectionfactory"); Connection connexion = fabrique.createconnection(); 22

23 Modèles Point à Point Queue Publish Subscribe Topic 23

24 JMS Queue Queue - Point à Point Schéma extrait du tutorial Le courtier/serveur JMS gère les files, les communications, la persistance 24

25 JMS Topic Topic - Publish-Subscribe Schéma extrait du tutorial 25

26 En détail, la session au centre JNDI Context 1) 2) 3) 4) 26

27 Context Recherche de l annuaire, ici OpenJMS JNDI Context // configuration dans le source Java Hashtable<String,String> props; props = new Hashtable<String,String>(); props.put(context.initial_context_factory, "org.exolab.jms.jndi.initialcontextfactory"); props.put(context.provider_url, "tcp://localhost:3035/"); Context contexte = new InitialContext(props); Voir javax.naming.context Ou bien en ligne de commande java -Djava.naming.factory.initial=org.exolab.jms.jndi.InitialContextFactory -Djava.naming.provider.url=tcp://localhost:3035/ Cf. le fichier jndi.properties 27

28 Context Recherche de l annuaire, ici OpenJMS JNDI Context Context contexte = new InitialContext(); // configuration via la ligne de commandes En ligne de commande java - Djava.naming.factory.initial=org.exolab.jms.jndi.InitialContextFactory -Djava.naming.provider.url=tcp://localhost:3035/ Cf. le fichier jndi.properties 28

29 Connection ConnectionFactory fabrique; fabrique = (ConnectionFactory) contexte.lookup("connectionfactory"); Connection connexion = fabrique.createconnection(); connexion.start(); Encapsulation d une connexion avec le courtier JMS Typique une connexion TCP/socket 29

30 Session Session session; session = connexion.createsession(false, Session.AUTO_ACKNOWLEDGE); // en mode transactionnel, commit(), rollback() // session = connexion.createsession(true, Session.AUTO_ACKNOWLEDGE); Création des files de messages et thèmes de publications Ajout des transactions, et d un envoi séquentiel des messages Accusé réception des messages envoyés 30

31 Destination (Queue par exemple) Destination dest; dest = (Destination) contexte.lookup("queue1"); Destination est un Objet JMS Queue / Topic Recherche de ce nom auprès du courtier JMS Avec OpenJMS l administrateur doit préalablement créer ces entrées 31

32 MessageProducer MessageProducer prod = session.createproducer(dest); TextMessage message; message = session.createtextmessage("hello"); prod.send(message); 32

33 MessageConsumer TextMessage message ; Message = (TextMessage)receiver.receive(); System.out.println(message.getText()); 33

34 Réception asynchrone : MessageListener public class Consumer implements MessageListener { public void onmessage(message message){ } TextMessage message ; Message = (TextMessage)receiver.receive(); System.out.println(message.getText()); } 34

35 Graphe de classes Queue QueueConnectionFactory QueueConnection QueueSession QueueSender QueueReceiver extends Destination extends ConnectionFactory extends Connection extends Session extends MessageProducer extends MessageConsumer idem pour Topic 35

36 Fabriques encore ConnectionFactory fabrique = (ConnectionFactory) contexte.lookup("connectionfactory"); QueueConnectionFactory fabrique = (QueueConnectionFactory) contexte.lookup("jmsqueueconnectionfactory"); TopicConnectionFactory fabrique = (TopicConnectionFactory) contexte.lookup("jmstopicconnectionfactory"); 36

37 Point à Point Queue En résumé Persistance des messages Réception synchrone ou asynchrone 37

38 Queue : un exemple extrait de // JNDI contexte InitialContext ctx = new InitialContext(props); QueueConnectionFactory qcf = (QueueConnectionFactory) ctx.lookup("jmsqueueconnectionfactory"); QueueConnection qc = qcf.createqueueconnection(); Queue queue = (Queue) ctx.lookup("queue1"); QueueSession qs = qc.createqueuesession(false, Session.AUTO_ACKNOWLEDGE); QueueReceiver receiver = qs.createreceiver(queue); qc.start(); 38

39 Publish-Subscribe Même schéma De programme, Concept identique au canal de communication Mais les messages publiés ne sont pas persistants Les messages publiés ne sont pas connus du souscripteur avant sa connexion 39

40 Extrait de programme, Publisher // contexte : JNDI contexte = new InitialContext(props); TopicConnectionFactory fabrique = (TopicConnectionFactory) contexte.lookup("jmstopicconnectionfactory"); TopicConnection connexion = fabrique.createtopicconnection(); TopicSession session = connexion.createtopicsession(false, Session.AUTO_ACKNOWLEDGE); Topic topic = (Topic) contexte.lookup(topicname); TopicPublisher sender = session.createpublisher(topic); connexion.start(); 40

41 Publisher, suite : envoi du message TextMessage message = session.createtextmessage("test"); sender.publish(message); Avec cette affectation, voir transparent précédent TopicPublisher sender = session.createpublisher(topic); 41

42 Un extrait : le Subscriber // contexte JNDI contexte = new InitialContext(props); TopicConnectionFactory fabrique = idem Publisher TopicSession session = idem Publisher Topic topic = idem Publisher in = session.createsubscriber(topic); in.setmessagelistener(this); } connexion.start(); public void onmessage(message message) { // traitement du message } 42

43 DurableSubscriber Persistance jusqu à ce que le souscripteur se réveille Même architecture TopicSubscriber subscriber; subscriber = session.createdurablesubscriber( topic, subscriptionname); C est tout 43

44 Souscription avec filtrage Abonnement conditionnel, sélectif Sélection des messages sur La valeur de leurs attributs Syntaxe sous-ensemble de SQL NOT, AND, OR, IS NULL BETWEEN.. LIKE 44

45 Souscription avec filtrage (2) Même architecture TopicSubscriber subscriber; subscriber = session.createdurablesubscriber( topic, subscriptionname, " valeur >10 AND nom LIKE urgent% ", true); Le booléen true inhibe les messages publiés au sein de la même connexion 45

46 Message TextMessage String gettext(), settext() MapMessage <Clé,Valeur> setstring(), getstring() BytesMessage flot de byte writebytes(), readbytes() StreamMessage flot type primitifs writestring(), ObjectMessage Objet sérialisé getobject(), setobject() 46

47 Détail sur les accusés de réception(ack) Mode Session.AUTO_ACKNOWLEDGE ACK, envoyé automatiquement À la fin de la méthode receive (synchone) Ou à la fin de la méthode onmessage (asynchrone) Mode Session.CLIENT_ACKNOWLEDGE ACK, effectué par le récepteur Appel de la méthode message.acknowledge() 47

48 Persistance, fiabilité, défaillance Le serveur JMS s arrête À la remise en état, tous les messages (persistants) sont de nouveau envoyés -> cela engendre donc qu un même message peut être reçu plusieurs fois Mode Session.AUTO_ACKNOWLEDGE Une table des ID des messages est conservée par le client, un test de la présence du message dans cette table évite la duplication Mode Session.DUPS_OK_ACKNOWLEDGE Lorsque la réception multiple ne pose pas de problèmes Mode Session.CLIENT_ACKNOWLEDGE Une exception est levée (ExceptionListener), c est au client d en tenir compte 48

49 Message, quelques méthodes «header» «content» Affectation des champs du «header» Un Message JMSMessageID JMSCorrelationID JMSExpiration JMSReplyTo JMSDestination 49

50 Message suite JMSMessageID: L identificateur unique du message JMSCorrelationID: Identification du message pour le client Lie une réponse à une requête, Le client vérifiera que ce nombre correspond à l identificateur envoyé JMSExpiration: Durée de vie d un message 0 : infini JMSReplyTo: Précisé par le client afin de répondre au message envoyé JMSDestination: Afin de connaître le destinataire 50

51 Patron Request Reply + Correlation ID Message msg = // («header») affectation du champ reply-to producer = session.createproducer(msg.getjmsreplyto msg.getjmsreplyto()); // («content») reply = session.createtextmessage(" ("reply reply"); // («header») Correl-ID == Message-ID reply.setjmscorrelationid(msg.getjmsmessageid msg.getjmsmessageid()); producer.send(reply reply); 51

52 Transaction un schéma public void execute(contexte ctxt){ try{ begintransaction(); envoi_du_message_m1(); envoi_du_message_m2(); committransaction(); }catch(exception e){ rollbacktransaction(); } } } 52

53 Avec JMS session = connection.createsession( true, Session.AUTO_ACKNOWLEDGE); Les Méthodes session.commit() session.rollback(); 53

54 Un exemple, OpenJMS public static void avectransaction() throws NamingException, JMSException { Connection connexion = null; Context contexte = null; try { // initialisation classique, page suivante Session session = null; try { // envoi, d'un message aux 3 files... Seules deux ont été déclarées session=connexion.createsession(true, Session.AUTO_ACKNOWLEDGE); Destination dest = (Destination) contexte.lookup("queue1"); MessageProducer sender = session.createproducer(dest); TextMessage message = session.createtextmessage("envoi_queue1"); sender.send(message); dest = (Destination) contexte.lookup("queue2"); sender = session.createproducer(dest); message = session.createtextmessage("envoi_queue2"); sender.send(message); dest = (Destination) contexte.lookup("queue_introuvable"); session.commit(); } catch (javax.naming.namenotfoundexception e) { System.out.println(e.getMessage() + " est introuvable, rollback"); session.rollback(); } catch (Exception e) {} 54

55 Exemple, 2/2 // initialisation classique, c.f. page précédente Hashtable<String, String> props = new Hashtable<String, String>(); props.put(context.initial_context_factory, "org.exolab.jms.jndi.initialcontextfactory"); props.put(context.provider_url, "tcp://localhost:3035/"); contexte = new InitialContext(props); ConnectionFactory fabrique = (ConnectionFactory) contexte.lookup("connectionfactory"); connexion = fabrique.createconnection(); connexion.start(); 55

56 Conclusion JMS Simple Quelques déclarations Deux modèles Point à point Publish/subscribe Si le courtier est en panne 56

57 MDB Message Driven Bean Intégration/collaboration JMS / serveur J2EE Traitements asynchrones Mail, base de données, impressions, Usage ActivationConfigProperty, 57

58 MDB j2ee Une instance MDB se comportera comme un écouteur «MessageListener», méthode onmessage() l EJB Container qui implémente MessageListener (JMS) Il gère un «pool» de MDB 58

59 Un MDB Annotation afin de devenir = "topic_mail"); // mappedname : c est le nom JNDI, // choisi pour le thème de souscription public class SendMailBean { // implements MessageListener // inutile, c.f. annotation } public void onmessage(message message){ // envoi du message/mail } Voir javax.annotation.resource 59

60 MDB, suite Annotation d annotation afin de devenir MDB, un vrai ce sont surtout les paramètres de configuration = "topic_mail", activationconfig={ // un tableau d // couples clé/valeur propertyname= "destinationtype", propertyvalue="javax.jms.topic"), ) } public class SendMailBean{ } 60

61 MDB, cycle de vie 61

62 Annotation, public class SendMailBean { // implements MessageListener // inutile, c.f. annotation } public void onmessage(message message){ // envoi du message/mail public void postconstruct(){. public void predestroy(){. } 62

63 Conclusion Discussion Démonstration d OpenJMS 63

64 Annexe Point-to-Point and publish-subscribe messaging models Guaranteed delivery of messages Synchronous and asynchronous message delivery Persistence using JDBC Local transactions Message filtering using SQL92-like selectors Authentication Administration GUI XML-based configuration files In-memory and database garbage collection Automatic client disconnection detection Applet support Integrates with Servlet containers such as Jakarta Tomcat Support for TCP, RMI, HTTP and SSL protocol stacks Support for large numbers of destinations and subscribers 64

65 OpenJMS 1) D:\openjms beta-1\bin>set JAVA_HOME=C:\jdk ) D:\openjms beta-1\bin>start startup D:\openjms beta-1\bin>start admin Exemples fournis, D:\openjms beta-1\examples\basic>build D:\openjms beta-1\examples\basic>start run Sender queue1 100 D:\openjms beta-1\examples\basic>start run Receiver queue1 100 D:\openjms beta-1\examples\basic>start run DurableSuscriber meteo 65

66 OpenJMS + hsqldb, /config/ Par défaut derby est utilisée <DatabaseConfiguration> <RdbmsDatabaseConfiguration driver="org.apache.derby.jdbc.embeddeddriver" url="jdbc:derby:openjmsdb;create=true" user="openjms" password="openjms"/> </DatabaseConfiguration> hsqldb <DatabaseConfiguration> <RdbmsDatabaseConfiguration driver="org.hsqldb.jdbcdriver" url="jdbc:hsqldb: user="sa" password=""/> </DatabaseConfiguration> Avec en préalable 1) java -cp../lib/hsqldb1.8.jar org.hsqldb.webserver -port 770 -silent true -database.0 file:openjmsdb -dbname.0 OPENJMSDB 2) dbtool -create -config D:\openjms beta-1\config\openjms.xml 66

67 Alternative à OpenJMS 67

68 Annexe Exemple extrait de Extrait de Context context = // JNDI context ConnectionFactory factory = // connection.start(); Requestor requestor = Requestor.newRequestor(connection,"request","reply","invalid"); Replier replier = Replier.newReplier(connection,"request","invalid"); requestor.send(); requestor.receivesync(); 68

69 Requestor initialize. private Destination replyqueue; private MessageProducer requestproducer; private MessageConsumer replyconsumer; private MessageProducer invalidproducer; Destination requestqueue = JndiUtil.getDestination(requestQueueName); replyqueue = JndiUtil.getDestination(replyQueueName); Destination invalidqueue = JndiUtil.getDestination(invalidQueueName); requestproducer = session.createproducer(requestqueue); replyconsumer = session.createconsumer(replyqueue); invalidproducer = session.createproducer(invalidqueue); } 69

70 Replier initialize. Destination requestqueue = JndiUtil.getDestination(requestQueueName); Destination invalidqueue = JndiUtil.getDestination(invalidQueueName); MessageConsumer requestconsumer = session.createconsumer(requestqueue); MessageListener listener = this; requestconsumer.setmessagelistener(listener); invalidproducer = session.createproducer(invalidqueue); 70

71 Requestor send public void send() throws JMSException { TextMessage requestmessage = session.createtextmessage(); requestmessage.settext("hello world."); requestmessage.setjmsreplyto(replyqueue); requestproducer.send(requestmessage); } } System.out.println("Sent request"); System.out.println("\tTime: " + System.currentTimeMillis() + " ms"); System.out.println("\tMessage ID: " + requestmessage.getjmsmessageid()); System.out.println("\tCorrel. ID: " + requestmessage.getjmscorrelationid()); System.out.println("\tReply to: " + requestmessage.getjmsreplyto()); System.out.println("\tContents: " + requestmessage.gettext()); 71

72 Replier, onmessage public void onmessage(message message) { try { if ((message instanceof TextMessage) && (message.getjmsreplyto()!= null)) { TextMessage requestmessage = (TextMessage) message; System.out.println("Received request"); System.out.println("\tTime: " + System.currentTimeMillis() + " ms"); System.out.println("\tMessage ID: " + requestmessage.getjmsmessageid()); System.out.println("\tCorrel. ID: " + requestmessage.getjmscorrelationid()); System.out.println("\tReply to: " + requestmessage.getjmsreplyto()); System.out.println("\tContents: " + requestmessage.gettext()); String contents = requestmessage.gettext(); Destination replydestination = message.getjmsreplyto(); MessageProducer replyproducer = session.createproducer(replydestination); TextMessage replymessage = session.createtextmessage(); replymessage.settext(contents); replymessage.setjmscorrelationid(requestmessage.getjmsmessageid()); replyproducer.send(replymessage); System.out.println("Sent reply"); System.out.println("\tTime: " + System.currentTimeMillis() + " ms"); System.out.println("\tMessage ID: " + replymessage.getjmsmessageid()); System.out.println("\tCorrel. ID: " + replymessage.getjmscorrelationid()); System.out.println("\tReply to: " + replymessage.getjmsreplyto()); System.out.println("\tContents: " + replymessage.gettext()); } else { // envoi sur invalidproducer 72

73 Requestor receivesync public void receivesync() throws JMSException { Message msg = replyconsumer.receive(); if (msg instanceof TextMessage) { TextMessage replymessage = (TextMessage) msg; System.out.println("Received reply "); System.out.println("\tTime: " + System.currentTimeMillis() + " ms"); System.out.println("\tMessage ID: " + replymessage.getjmsmessageid()); System.out.println("\tCorrel. ID: " + replymessage.getjmscorrelationid()); System.out.println("\tReply to: " + replymessage.getjmsreplyto()); System.out.println("\tContents: " + replymessage.gettext()); } else { // envoi sur invalidproducer 73

74 Traces d exécution avec OpenJMS Notez l affectation de Correl ID, lors de la réponse 74

75 JMS et Chat Extrait de Un bon exemple de mise en oeuvre 75

76 Exemple de déploiement, JMS-MDB Source : 76