SMom.Dispatcher
Interface IDispatcher

All Known Implementing Classes:

CSinchronusAndSequentialDispatcher

public interface IDispatcher

Interfaccia di un Dispatcher di messaggi.

Un Dispatcher consente di decidere le politiche per l'invio e la ricezione di messaggi _ (es: lavorare in maniera sincrona/asincrona, decidere quante code di entrate/uscita usare, ecc...). L'oggetto utilizza un MsgManager per inviare fisicamente i messaggi utilizzando quindi i _ meccanismi di spedizione implementati da tale oggetto. Se alla richiesta di invio di un messaggio non è ancora stato collegato un MsgManager, il messaggio verrà scartato.

Version:

0.1 - Settembre 2004

Author:

Giorgio Bernardi.
E-Mail: Giorgio.Bernardi@studio.unibo.it

Method Summary

IMsgManager	getMsgManager() Identificativo dell'oggetto che si occuperà di spedire i messaggi ai destinatari
boolean	msgArrived(CEnvelope Env) Funzione di CallBack chiamata dal Manager che richiede al dispatcher di inviare il messaggio ad uno dei riceventi registratisi
boolean	Register(IReceiver Receiver) Funzione che permette ad un possibile destinatario di messaggi, di registrarsi presso il dispatcher
boolean	Send(CEnvelope Env, java.lang.String MngAddress) Funzione che permette di inviare un messaggio ad un Manager di messaggi destinatario Per poter inviare un messaggio è necessario aver legato il dispatcher ad un MsgManager!
void	setMsgManager(IMsgManager dsptchr) Identificativo dell'oggetto che si occuperà di spedire i messaggi ai destinatari
boolean	UnRegister(IReceiver Receiver) Funzione che permette ad un possibile destinatario di messaggi, precedentemente registratosi, di deregistrarsi presso il dispatcher
boolean	UnRegister(java.lang.String ReceiverObjectID) Funzione che permette ad un possibile destinatario di messaggi, precedentemente registratosi, di deregistrarsi presso il dispatcher

Method Detail

getMsgManager

public IMsgManager getMsgManager()

Identificativo dell'oggetto che si occuperà di spedire i messaggi ai destinatari

setMsgManager

public void setMsgManager(IMsgManager dsptchr)

Identificativo dell'oggetto che si occuperà di spedire i messaggi ai destinatari

Register

public boolean Register(IReceiver Receiver)

Funzione che permette ad un possibile destinatario di messaggi, di registrarsi presso il dispatcher

UnRegister

public boolean UnRegister(IReceiver Receiver)

Funzione che permette ad un possibile destinatario di messaggi, precedentemente registratosi, di deregistrarsi presso il dispatcher

UnRegister

public boolean UnRegister(java.lang.String ReceiverObjectID)

Funzione che permette ad un possibile destinatario di messaggi, precedentemente registratosi, di deregistrarsi presso il dispatcher

msgArrived

public boolean msgArrived(CEnvelope Env)

Funzione di CallBack chiamata dal Manager che richiede al dispatcher di inviare il messaggio ad uno dei riceventi registratisi

Send

public boolean Send(CEnvelope Env,
                    java.lang.String MngAddress)

Funzione che permette di inviare un messaggio ad un Manager di messaggi destinatario Per poter inviare un messaggio è necessario aver legato il dispatcher ad un MsgManager! Restituisce False se l'invio non va a buon fine. Le implementazioni di questa interfaccia indicheranno i motivi specifici per cui è possibile che si verifichi un errore (esempio: Manager _ destinazione sconosciuto)