CEnvelope

Rappresentazione di una busta (lettera) tramite cui si inviano messaggi con il middleware

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

La classe rappresenta una busta a livello applicativo. A basso livello il messaggio verrà incapsulato in maniera differente a seconda del Canale usato per la spedizione.
In fase di ricezione il messaggio viene ricreato prima di consegnarlo al ricevente e alla busta vengono aggiunte le informazioni di tracciabilità per consentire un Replay del messaggio in maniera quanto più automatica possibile.

CharDelimiter

Private Const CharDelimiter As String = ":"

Carattere delimitatore utilizzato

mReceiver

Private mReceiver       As IReceiver

Attributo contenente il valore della proprietà omonima dell'oggetto

mSender

Private mSender         As ISender

Attributo contenente il valore della proprietà omonima dell'oggetto

mstrMessage

Private mstrMessage     As String

Attributo contenente il valore della proprietà omonima dell'oggetto

mTraceRoute

Private mTraceRoute     As CEnvelopeTrace

Attributo contenente il valore della proprietà omonima dell'oggetto

Message

Public Property Get Message() As String

Rappresentazione in forma di stringa del messaggio da inviare

Message

Public Property Let Message(msg As String)

Rappresentazione in forma di stringa del messaggio da inviare

Receiver

Public Property Get Receiver() As IReceiver

Identificativo del destinatario del messaggio

Receiver

Public Property Set Receiver(rcvr As IReceiver)

Identificativo del destinatario del messaggio

Sender

Public Property Get Sender() As ISender

Identificativo del mittente del messaggio

Sender

Public Property Set Sender(sndr As ISender)

Identificativo del mittente del messaggio

TraceRoute

Public Property Get TraceRoute() As CEnvelopeTrace

Informazioni per la tracciabilità del messaggio
Questo attributo viene valorizzato dal Manager e dal Dispatcher di ricezione.

TraceRoute

Public Property Set TraceRoute(sndr As CEnvelopeTrace)

Informazioni per la tracciabilità del messaggio
Questo attributo viene valorizzato dal Manager e dal Dispatcher di ricezione.

fromString

Public Function fromString(ByVal StrEnvelope As String) As Boolean

Permette di creare un oggetto CEnvelope ottenendo i dati dalla rappresentazione in forma di stringa.

Replay

Public Function Replay(Message As String, Optional ByVal MsgSender As ISender = Nothing) As Boolean

Grazie alle funzionalità di tracciabilità è possibile rispondere al messaggio semplicemente indicando il messaggio di ritorno
La funzione restituisce il risultato della Send applicata al MsgManager locale che ha ricevuto il messaggio.
Non è ovviamente garantito che il MsgManager di origine conosca il Receiver.

SetReceiverByObjectID

Public Sub SetReceiverByObjectID(ObjID As String)

Setta come ricevente un semplice segnaposto con l'ID indicato

toString

Public Function toString() As String

Permette di recuperare una rappresentazione in forma di stringa dell'oggetto
Formato:
||