org.zlatan
Class PurchaseOrderReceiver

java.lang.Object
  extended byorg.zlatan.PurchaseOrderReceiver

public class PurchaseOrderReceiver
extends java.lang.Object

Questa classe è a tutti gli effetti un proxy per semplificare la ricezione di ordini di acquisto attraverso JMS. Viene utilizzata da diverse classi del modulo IBRA.

See Also:
PurchaseOrderSender, org.zlatan.ibra, PurchaseOrderType

Constructor Summary
PurchaseOrderReceiver(javax.jms.Connection connection, javax.jms.Destination destination)
          Costruttore che crea un proxy a partire dalla connessione e dalla destinazione già create come oggetti.
PurchaseOrderReceiver(java.lang.String connFactory, java.lang.String destName)
          Costruttore che crea un proxy a partire dalle stringhe che specificano il nome JNDI della ConnectionFactory da utilizzare e della coda JMS su cui ricevere i messaggi.
 
Method Summary
 void close()
          Chiude il proxy e pulisce gli oggetti creati.
 PurchaseOrderType receivePurchaseOrder()
          Controlla la presenza di un messaggio, eventualmente ne controlla il formato e se lo riconosce come serializzazione binaria di PurchaseOrderType lo deserializza e lo fornisce in uscita.
 javax.jms.Message receivePurchaseOrderMessage()
          Ritorna il primo messaggio disponibile sulla coda senza deserializzarlo.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PurchaseOrderReceiver

public PurchaseOrderReceiver(java.lang.String connFactory,
                             java.lang.String destName)
                      throws javax.jms.JMSException,
                             javax.naming.NamingException
Costruttore che crea un proxy a partire dalle stringhe che specificano il nome JNDI della ConnectionFactory da utilizzare e della coda JMS su cui ricevere i messaggi.

Parameters:
connFactory - la stringa con il nome JNDI della ConnectionFactory (es. jms/QueueConnectionFactory)
destName - la stringa con il nome JNDI della coda JMS dalla quale prelevare i messaggi contenenti gli ordini di acquisto (es. jms/Queue)

PurchaseOrderReceiver

public PurchaseOrderReceiver(javax.jms.Connection connection,
                             javax.jms.Destination destination)
                      throws javax.jms.JMSException,
                             javax.naming.NamingException
Costruttore che crea un proxy a partire dalla connessione e dalla destinazione già create come oggetti. Particolarmente utile nel caso si ricevano messaggi da una coda temporanea.

Parameters:
connection - la connessione JMS da utilizzare, già inizializzata
destination - la destinazione JMS da utilizzare, già inizializzata
Method Detail

receivePurchaseOrder

public PurchaseOrderType receivePurchaseOrder()
                                       throws javax.jms.JMSException
Controlla la presenza di un messaggio, eventualmente ne controlla il formato e se lo riconosce come serializzazione binaria di PurchaseOrderType lo deserializza e lo fornisce in uscita.

Returns:
l'ordine di acquisto eventualmente trovato nel messaggio
Throws:
javax.jms.JMSException

receivePurchaseOrderMessage

public javax.jms.Message receivePurchaseOrderMessage()
                                              throws javax.jms.JMSException
Ritorna il primo messaggio disponibile sulla coda senza deserializzarlo. Utile nel caso in cui si voglia inoltrare il messaggio su un'altra coda JMS.

Returns:
il primo messaggio disponibile nella coda, null se non ce ne sono
Throws:
javax.jms.JMSException

close

public void close()
           throws javax.naming.NamingException,
                  javax.jms.JMSException
Chiude il proxy e pulisce gli oggetti creati.

Throws:
javax.naming.NamingException
javax.jms.JMSException