Connection factories e destinazioni: sono oggetti amministrati da JNDI.

Transcript

1 1 JMS Gli elementi fondamentali di un applicazione JMS sono: Connection factories e destinazioni: sono oggetti amministrati da JNDI. Connection Factories: sono oggetti che il client usa per creare connessioni con il provider che incapsulano un inseme di parametri per la connessione. Ogni connection factory è un istanza di QueueConnectionFactory o TopicConnectionFactory. Questi nomi sono anche quelli utilizzati di default da J2EE. Per creare delle nuove connection factory da J2EE: j2eeadmin -addjmsfactory MiaQFactory queue j2eeadmin -addjmsfactory MiaTFactory topic Quando un client vuole ottenere una connection factory: Context ctx = new I n i t i a l C o n t e x t ( ) ; QueueConnectionFactory queueconnectionfactory =( QueueConnectionFactory ) c t x. lookup ( QueueConnectionFactory ) ; TopicConnectionFactory topicconnectionfactory =(TopicConnectionFactory ) ctx. lookup ( TopicConnectionFactory ) ; Destinazioni: sono oggetti sche il client usa come destinazioni o sorgenti di messaggi. Nel dominio P2P le destinazioni sono chiamate queue, mentre nel dominio publish/subscribe sono chiamate topic. Per creare delle nuove destinazioni da J2EE: j2eeadmin -addjmsdestination MiaQueue queue j2eeadmin -addjmsdestination MioTopic topic In JBOSS: <?xml version= 1. 0 encoding= UTF 8?> <s e r v e r> <mbean code= org. j b o s s.mq. s e r v e r. jmx. Queue name= j b o s s.mq. d e s t i n a t i o n : s e r v i c e=queue, name=myqueue > <depends o p t i o n a l a t t r i b u t e name= DestinationManager >j b o s s. m q : s e r v i c e= DestinationManager</ depends> </mbean> </ s e r v e r> Per ottenere delle destinazioni: Topic mytopic = ( Topic ) ctx. lookup ( MyTopic ) ; Queue myqueue = ( Queue ) ctx. lookup ( MyQueue ) ; Connessioni: sono connessioni virtuali con un provider JMS. Per ottenere delle connesioni a partire da connection factory in precedenza istanziate: QueueConnection queueconnection = queueconnectionfactory. createqueueconnection ( ) ; TopicConnection topicconnection = topicconnectionfactory. createtopicconnection ( ) ; Per poter iniziare a consumare messaggi bisogna chiamare il metodo start sulla connessione, il metodo stop invece disabilita temporaneamente la consegna di messaggi senza chiudere la connessione.per chiudere completamente la connessione bisogna invocare il suo metodo close(). Sessioni: sono contesti nei quali si possono produrre e consumare messaggi. Vengono usate per creare produttori, consumatori e messaggi. 1

2 T opicsession t o p i c S e s s i o n = topicconnection. c r e a t e T o p i c S e s s i o n ( false, S e s s i o n. AUTO ACKNOWLEDGE) ; QueueSession queuesession = queueconnection. createqueuesession ( true, 0) ; Nel caso della topicsession di cui sopra false indica che la sessione non è transazionale mentre Session.AUTO ACKNOWLEDGE significa che la sessione notifica automaticamente i messaggi che sono stati ricevuti con successo. Produttori: sono oggetti creati dalla sessione e servono ad inviare messaggi. QueueSender queuesender = queuesession. c r e a t e S e n d e r (myqueue) ; TopicPublisher t o p i c P u b l i s h e r = t o p i c S e s s i o n. c r e a t e P u b l i s h e r ( mytopic ) ; I messaggi vengono inviati tramite il metodo send o publish: queuesender. send ( message ) ; t o p i c P u b l i s h e r. p u b l i s h ( message ) ; Consumatori: sono oggetti creati dalla sessione e servono a ricevere messaggi. QueueReceiver queuereceiver = queuesession. c r e a t e R e c e i v e r (myqueue) ; TopicSubscriber t o p i c S u b s c r i b e r =t o p i c S e s s i o n. c r e a t e S u b s c r i b e r ( mytopic ) ; Una volta creato il consumatore, questo diventa attivo cioè pronto a ricevere messaggi, per renderlo inattivo bisogna chiamare il metodo close(). La consegnadi messaggi comunque non inizia finchè non viene chiamato il metodo start sulla connessione. Si può usare poi il metodo receive() per consumare i messaggi in modalità sincrona (sempre dopo aver invocato start sulla connessione). Invece per consumare i messaggi in modalità asincrona si usa un message listener. Message listener: è un oggetto che si comporta come un gestore di eventi asincroni. Implementa l interfaccia MessageListener che contiene un metodo, onmessage. Nell implementazione di tale metodo viene specificato il comportamento alla ricezione del messaggio. Il consumatore si registra al listener di interesse: T o p i c L i s t e n e r t o p i c L i s t e n e r = new T o p i c L i s t e n e r ( ) ; t o p i c S u b s c r i b e r. s e t M e s s a g e L i s t e n e r ( t o p i c L i s t e n e r ) ; Messaggi: Un messaggio è composto da: Header: ogni campo dello header ha i metodi set e get. Alcuni campi devono essere settati esplicitamente ma la maggior parte di essi viene settata automaticamente dai metodi send o publish (e in questi casi gli eventuali campi già settati manualmente vengono sovrascritti). Properties (opzionali) Body (opzionale): ci sono 5 tipi divers di body: TextMessage: messaggio testuale MapMessage: coppie nome/valore in cui il noe è una stringa ed il valore è un tipo primitivo di java. ByteMessage: uno strem di bytes StreamMessage: uno stream di valori primitivi di java ObjectMessage: un oggetto di tipo serializzabile Message: costituito dai soli campi header e properties 2

3 Per creare un messaggio di tipo testuale: TextMessage message = queuesession. createtextmessage ( ) ; message. settext ( msg text ) ; // m s g t e x t è d i t i p o S t r i n g queuesender. send ( message ) ; Quando il messaggio viene consumato esso arriva come messaggio generico (di tipo Message) e quindi deve essere fatto il cast al tipo appropriato. Message m = queuereceiver. r e c e i v e ( ) ; i f (m instanceof TextMessage ) TextMessage message = ( TextMessage ) m; System. out. p r i n t l n ( Reading message : + message. gettext ( ) ) ; else // G e s t i s c i l e r r o r e 1.1 Esempio MDB Un semplice esempio di Message Driven Bean che utilizza una coda per ricevere messaggi. import javax. e j b. MessageDrivenBean ; import javax. e j b. MessageDrivenContext ; import javax. jms. Message ; import javax. jms. MessageListener ; import javax. jms. TextMessage ; Listing 1: FirstMDB.java public class FirstMDB implements MessageDrivenBean, MessageListener public void ejbcreate ( ) System. out. p r i n t l n ( Creo l MDB ) ; public void setmessagedrivencontext ( MessageDrivenContext c x t ) System. out. p r i n t l n ( Setto i l c o n t e s t o ) ; public void ejbremove ( ) System. out. p r i n t l n ( Rimuovo l MDB ) ; public void onmessage ( Message msg ) System. out. p r i n t l n ( Ricevuto un messaggio ) ; S t r i n g t e x t = null ; i f ( msg instanceof TextMessage ) try t e x t = ( ( TextMessage ) msg ). gettext ( ) ; System. out. p r i n t l n ( +t e x t ) ; catch ( Exception ex ) ex. printstacktrace ( ) ; else System. out. p r i n t l n ( non è un messaggio t e s t u a l e! ) ; 3

4 Listing 2: MDBClient.java public class MDBClient public s t a t i c void main ( S t r i n g arg [ ] ) try / S o l u z i o n e 1 : In a l t e r n a t i v a a l j n d i. p r o p e r t i e s / / j a v a. u t i l. P r o p e r t i e s prop = new j a v a. u t i l. P r o p e r t i e s ( ) ; prop. put ( Context.INITIAL CONTEXT FACTORY, org. jnp. i n t e r f a c e s. NamingContextFactory ) ; prop. put ( Context.URL PKG PREFIXES, org. jnp. i n t e r f a c e s ) ; prop. put ( Context.PROVIDER URL, l o c a l h o s t ) ; Context c o n t e x t = new I n i t i a l C o n t e x t ( prop ) ; / / S o l u z i o n e 1 / / S o l u z i o n e 2 : Contesto preso d a l f i l e j n d i. p r o p e r t i e s / Context context = new I n i t i a l C o n t e x t ( ) ; / S o l u z i o n e 2 / // Look up d e l l a connection f a c t o r y ( QueueConnectionFactory è q u e l l a d i d e f a u l t per JBOSS) QueueConnectionFactory queuefactory =( QueueConnectionFactory ) c o n t e x t. lookup ( QueueConnectionFactory ) ; // Crea una connessione con i l JMS p r o v i d e r QueueConnection queueconnection = queuefactory. createqueueconnection ( ) ; // Crea una s e s s i o n e QueueSession s e s s i o n = queueconnection. createqueuesession ( false, S e s s i o n.auto ACKNOWLEDGE) ; // Lookup d e l l a coda d i d e s t i n a z i o n e su c u i p u b b l i c a r e Queue queue = ( Queue ) context. lookup ( queue / f i r s t Q u e u e ) ; // Crea un p r o d u t t o r e QueueSender queuesender = s e s s i o n. c r e a t e S e n d e r ( queue ) ; // Crea un messaggio d i t e s t o TextMessage message = s e s s i o n. createtextmessage ( ) ; message. settext ( H e l l o World! ) ; // I n v i a i l messaggio queuesender. send ( message ) ; // Chiude l a connessione queueconnection. c l o s e ( ) ; catch ( Exception e ) e. printstacktrace ( ) ; Listing 3: jndi.properties java. naming. f a c t o r y. i n i t i a l=org. jnp. i n t e r f a c e s. NamingContextFactory java. naming. p r o v i d e r. u r l=jnp : // l o c a l h o s t :1099 java. naming. f a c t o r y. u r l. pkgs=org. j b o s s. naming : org. jnp. i n t e r f a c e s <?xml version= 1. 0 Listing 4: META-INF/ejb-jar.xml encoding= UTF 8?> <!DOCTYPE ejb j a r PUBLIC //Sun Microsystems, Inc. / /DTD E n t e r p r i s e JavaBeans 2.0//EN h t t p : // java. sun. com/ dtd / ejb j a r 2 0. dtd > <ejb j a r> <e n t e r p r i s e beans> 4

5 <message driven> <ejb name>firstmdb</ ejb name> <ejb c l a s s>firstmdb</ ejb c l a s s> <message driven d e s t i n a t i o n> <d e s t i n a t i o n type> javax. jms. Queue </ d e s t i n a t i o n type> </ message driven d e s t i n a t i o n> <t r a n s a c t i o n type>container</ t r a n s a c t i o n type> </ message driven> </ e n t e r p r i s e beans> </ ejb j a r> <j b o s s> <e n t e r p r i s e beans> <message driven> <ejb name>firstmdb</ ejb name> <d e s t i n a t i o n jndi name> f i r s t Q u e u e </ d e s t i n a t i o n jndi name> </ message driven> </ e n t e r p r i s e beans> </ j b o s s> Listing 5: META-INF/jboss.xml 1.2 Esempio Queue Listing 6: Receiver.java class T e x t L i s t e n e r implements MessageListener public void onmessage ( Message message ) try TextMessage txtmsg=(textmessage ) message ; System. out. p r i n t l n ( r i c e v u t o : +txtmsg. gettext ( ) ) ; catch ( JMSException e r r o r ) System. out. p r i n t l n ( hai r i c e v u t o una e c c e z i o n e : +e r r o r. getmessage ( ) ) ; public class Receiver QueueConnectionFactory c f = null ; QueueConnection c onnection = null ; QueueSession s e s s i o n = null ; Queue d e s t i n a t i o n = null ; QueueReceiver r e c e i v e r = null ; // TextMessage message = n u l l ; 5

6 c f = ( QueueConnectionFactory ) ctx. lookup ( ConnectionFactory ) ; d e s t i n a t i o n = ( Queue ) ctx. lookup ( queue /miacoda ) ; c onnection = c f. createqueueconnection ( ) ; s e s s i o n = connection. createqueuesession ( false, r e c e i v e r = s e s s i o n. c r e a t e R e c e i v e r ( d e s t i n a t i o n ) ; r e c e i v e r. s e t M e s s a g e L i s t e n e r (new T e x t L i s t e n e r ( ) ) ; c onnection. s t a r t ( ) ; System. out. p r i n t l n ( La c o n n e s s i o n e e p a r t i t a, sono in a t t e s a d i un messaggio ) ; Listing 7: Sender.java public class Sender QueueConnectionFactory c f = null ; QueueConnection c onnection = null ; QueueSession s e s s i o n = null ; Queue d e s t i n a t i o n = null ; QueueSender sender = null ; TextMessage message = null ; c f = ( QueueConnectionFactory ) ctx. lookup ( ConnectionFactory ) ; d e s t i n a t i o n = ( Queue ) ctx. lookup ( queue /miacoda ) ; c onnection = c f. createqueueconnection ( ) ; s e s s i o n = connection. createqueuesession ( false, sender = s e s s i o n. c r e a t e S e n d e r ( d e s t i n a t i o n ) ; message = s e s s i o n. createtextmessage ( ) ; message. settext ( a r g s [ 0 ] ) ; System. out. p r i n t l n ( I n v i o d e l messaggio d i a llarme in c o r s o.. \n ) ; sender. send ( message ) ; 6

7 c onnection. c l o s e ( ) ; System. out. p r i n t l n ( Messaggio di allarme i n v i a t o correttamente. ) ; 1.3 Esempio Topic Listing 8: Publisher.java public class P u b l i s h e r TopicConnectionFactory c f = null ; TopicConnection connection = null ; T opicsession s e s s i o n = null ; Topic d e s t i n a t i o n = null ; TopicPublisher p u b l i s h e r = null ; TextMessage message = null ; c f = ( TopicConnectionFactory ) ctx. lookup ( ConnectionFactory ) ; d e s t i n a t i o n = ( Topic ) ctx. lookup ( t o p i c / i n c e n d i o ) ; c onnection = c f. createtopicconnection ( ) ; s e s s i o n = connection. c r e a t e T o p i c S e s s i o n ( false, p u b l i s h e r = s e s s i o n. c r e a t e P u b l i s h e r ( d e s t i n a t i o n ) ; message = s e s s i o n. createtextmessage ( ) ; message. settext ( a r g s [ 0 ] ) ; System. out. p r i n t l n ( I n v i o d e l messaggio d i a llarme in c o r s o.. \n ) ; p u b l i s h e r. send ( message ) ; c onnection. c l o s e ( ) ; System. out. p r i n t l n ( Messaggio di allarme i n v i a t o correttamente. ) ; Listing 9: Subscriber.java class T e x t L i s t e n e r implements MessageListener 7

8 public void onmessage ( Message message ) try TextMessage txtmsg=(textmessage ) message ; System. out. p r i n t l n ( r i c e v u t o : +txtmsg. gettext ( ) ) ; catch ( JMSException e r r o r ) System. out. p r i n t l n ( hai r i c e v u t o una e c c e z i o n e : +e r r o r. getmessage ( ) ) ; public class S u b s c r i b e r TopicConnectionFactory c f = null ; TopicConnection connection = null ; T opicsession s e s s i o n = null ; Topic d e s t i n a t i o n = null ; TopicSubscriber s u b s c r i b e r = null ; // TextMessage message = n u l l ; c f = ( TopicConnectionFactory ) ctx. lookup ( ConnectionFactory ) ; d e s t i n a t i o n = ( Topic ) ctx. lookup ( t o p i c / i n c e n d i o ) ; c onnection = c f. createtopicconnection ( ) ; s e s s i o n = connection. c r e a t e T o p i c S e s s i o n ( false, s u b s c r i b e r = s e s s i o n. c r e a t e S u b s c r i b e r ( d e s t i n a t i o n ) ; s u b s c r i b e r. s e t M e s s a g e L i s t e n e r (new T e x t L i s t e n e r ( ) ) ; c onnection. s t a r t ( ) ; System. out. p r i n t l n ( La c o n n e s s i o n e e p a r t i t a, sono in a t t e s a d i un messaggio ) ; 1.4 Esempio Topic Selection Listing 10: Publisher.java public class P u b l i s h e r 8

9 TopicConnectionFactory c f = null ; TopicConnection connection = null ; T opicsession s e s s i o n = null ; Topic d e s t i n a t i o n = null ; TopicPublisher p u b l i s h e r = null ; TextMessage message = null ; c f = ( TopicConnectionFactory ) ctx. lookup ( ConnectionFactory ) ; d e s t i n a t i o n = ( Topic ) ctx. lookup ( t o p i c / allarme ) ; c onnection = c f. createtopicconnection ( ) ; s e s s i o n = connection. c r e a t e T o p i c S e s s i o n ( false, p u b l i s h e r = s e s s i o n. c r e a t e P u b l i s h e r ( d e s t i n a t i o n ) ; message = s e s s i o n. createtextmessage ( ) ; message. s e t S t r i n g P r o p e r t y ( tipoallarme, a r g s [ 0 ] ) ; message. settext ( a r g s [ 1 ] ) ; TextMessage txtmsg=(textmessage ) message ; System. out. p r i n t l n ( I n v i o d e l messaggio d i a llarme in c o r s o.. \n ) ; p u b l i s h e r. send ( message ) ; c onnection. c l o s e ( ) ; System. out. p r i n t l n ( Messaggio di allarme i n v i a t o correttamente. ) ; Listing 11: Subscriber.java class T e x t L i s t e n e r implements MessageListener public void onmessage ( Message message ) try TextMessage txtmsg=(textmessage ) message ; System. out. p r i n t l n ( r i c e v u t o : +txtmsg. gettext ( ) ) ; catch ( JMSException e r r o r ) System. out. p r i n t l n ( hai r i c e v u t o una e c c e z i o n e : +e r r o r. getmessage ( ) ) ; public class S u b s c r i b e r 9

10 TopicConnectionFactory c f = null ; TopicConnection connection = null ; T opicsession s e s s i o n = null ; Topic d e s t i n a t i o n = null ; TopicSubscriber s u b s c r i b e r = null ; // TextMessage message = n u l l ; S t r i n g s e l e c t o r = null ; c f = ( TopicConnectionFactory ) ctx. lookup ( ConnectionFactory ) ; d e s t i n a t i o n = ( Topic ) ctx. lookup ( t o p i c / allarme ) ; c onnection = c f. createtopicconnection ( ) ; s e s s i o n = connection. c r e a t e T o p i c S e s s i o n ( false, // d i c h i a r o che intendo u t i l i z z a r e un s e l e t t o r e s e l e c t o r = tipoallarme = i n c e n d i o ; s u b s c r i b e r = s e s s i o n. c r e a t e S u b s c r i b e r ( d e s t i n a t i o n, s e l e c t o r, f a l s e ) ; s u b s c r i b e r. s e t M e s s a g e L i s t e n e r (new T e x t L i s t e n e r ( ) ) ; c onnection. s t a r t ( ) ; System. out. p r i n t l n ( La c o n n e s s i o n e e p a r t i t a, sono in a t t e s a d i un messaggio ) ; Listing 12: Subscriber2.java class TextListener2 implements MessageListener public void onmessage ( Message message ) try TextMessage txtmsg=(textmessage ) message ; System. out. p r i n t l n ( r i c e v u t o : +txtmsg. gettext ( ) ) ; catch ( JMSException e r r o r ) System. out. p r i n t l n ( hai r i c e v u t o una e c c e z i o n e : +e r r o r. getmessage ( ) ) ; public class S u b s c r i b e r 2 10

11 TopicConnectionFactory c f = null ; TopicConnection connection = null ; T opicsession s e s s i o n = null ; Topic d e s t i n a t i o n = null ; TopicSubscriber s u b s c r i b e r = null ; // TextMessage message = n u l l ; S t r i n g s e l e c t o r = null ; c f = ( TopicConnectionFactory ) ctx. lookup ( ConnectionFactory ) ; d e s t i n a t i o n = ( Topic ) ctx. lookup ( t o p i c / allarme ) ; c onnection = c f. createtopicconnection ( ) ; s e s s i o n = connection. c r e a t e T o p i c S e s s i o n ( false, // d i c h i a r o che intendo u t i l i z z a r e un s e l e t t o r e s e l e c t o r = tipoallarme = rapina ; s u b s c r i b e r = s e s s i o n. c r e a t e S u b s c r i b e r ( d e s t i n a t i o n, s e l e c t o r, f a l s e ) ; s u b s c r i b e r. s e t M e s s a g e L i s t e n e r (new TextListener2 ( ) ) ; c onnection. s t a r t ( ) ; System. out. p r i n t l n ( La c o n n e s s i o n e e p a r t i t a, sono in a t t e s a d i un messaggio ) ; 1.5 Esempio Queue con lettura sincrona Listing 13: ReceiverSync.java public class ReceiverSync QueueConnectionFactory c f = null ; QueueConnection c onnection = null ; QueueSession s e s s i o n = null ; Queue d e s t i n a t i o n = null ; QueueReceiver r e c e i v e r = null ; 11

12 TextMessage message = null ; c f = ( QueueConnectionFactory ) ctx. lookup ( ConnectionFactory ) ; d e s t i n a t i o n = ( Queue ) ctx. lookup ( queue /miacoda ) ; c onnection = c f. createqueueconnection ( ) ; s e s s i o n = connection. createqueuesession ( false, r e c e i v e r = s e s s i o n. c r e a t e R e c e i v e r ( d e s t i n a t i o n ) ; c onnection. s t a r t ( ) ; do message=(textmessage ) r e c e i v e r. r e c e i v e ( ) ; System. out. p r i n t l n ( r i c e v u t o messaggio : +message. gettext ( ) ) ; while (! message. gettext ( ). e q u a l s ( stop ) ) ; Listing 14: SenderSync.java public class SenderSync QueueConnectionFactory c f = null ; QueueConnection c onnection = null ; QueueSession s e s s i o n = null ; Queue d e s t i n a t i o n = null ; QueueSender sender = null ; TextMessage message = null ; c f = ( QueueConnectionFactory ) ctx. lookup ( ConnectionFactory ) ; d e s t i n a t i o n = ( Queue ) ctx. lookup ( queue /miacoda ) ; c onnection = c f. createqueueconnection ( ) ; s e s s i o n = connection. createqueuesession ( false, 12

13 sender = s e s s i o n. c r e a t e S e n d e r ( d e s t i n a t i o n ) ; message = s e s s i o n. createtextmessage ( ) ; message. settext ( a r g s [ 0 ] ) ; System. out. p r i n t l n ( I n v i o d e l messaggio d i a llarme in c o r s o.. \n ) ; sender. send ( message ) ; c onnection. c l o s e ( ) ; System. out. p r i n t l n ( Messaggio di allarme i n v i a t o correttamente. ) ; 13