IMsgManager

Interfaccia di un Manager che consente di inviare e ricevere messaggi

Autore: Giorgio Bernardi
E-Mail: Giorgio.Bernardi@studio.unibo.it
Data : Settembre 2004

Un Manager consente di interfacciarsi con altri Manager per poter scambiare messaggi a basso livello. Per poter inviare un messaggio è necessario usare il metodo Send, mentre alla ricezione di un messaggio, il Manager si incaricherà di passare al Dispatcher collegato il messaggio che sarà recapitato al ricevente.
Oggetti che implementano questa interfaccia devono contenere i meccanismi di spedizione e di ricezione di messaggi. Le politiche per l'invio e la ricezione, al contrario, vanno implementate nei Dispatcher.
Il Manager dovrebbe funzionare in modo sequenziale e sincrono, facendo rimanere in attesa il cliente sia durante una ricezione, sia durante una spedizione.
Se all'arrivo di un messaggio non è ancora stato collegato un Dispatcher, il messaggio verrà scartato.

Codice
Properties Summary
Get Public(IDispatcher)
Set Public(IDispatcher)
Property Get Dispatcher()
Property Set Dispatcher( dsptchr As IDispatcher)

Codice
Identificativo dell'oggetto che si occuperà di indirizzare i messaggi ai destinatari
 
Method Summary
Public(String) getAddress()
Codice
Indirizzo logico del manager. Identifica il manager specificandolo in maniera univoca
Public(Boolean) Send( Env As CEnvelope, MngAddress As String)
Codice
Funzione che permette di inviare un messaggio ad un Manager di messaggi destinatario
 
Details

Dispatcher

Public Property Get Dispatcher() As IDispatcher

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

Dispatcher

Public Property Set Dispatcher(dsptchr As IDispatcher)

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

getAddress

Public Function getAddress() As String

Codice
Indirizzo logico del manager. Identifica il manager specificandolo in maniera univoca

Send

Public Function Send(Env As CEnvelope, MngAddress As String) As Boolean

Codice
Funzione che permette di inviare un messaggio ad un Manager di messaggi destinatario
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)