SMom
Class CEnvelope

java.lang.Object
  |
  +--SMom.CEnvelope

public class CEnvelope

extends java.lang.Object

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

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.

Version:

0.1 - Settembre 2004

Author:

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

Field Summary

protected static java.lang.String

CharDelimiter Carattere usato come delimitatore per le intestazioni dei messaggi

Constructor Summary

CEnvelope()
Costruttore di default della busta vuota

CEnvelope(ISender Sender, IReceiver Receiver, java.lang.String Message)
Costruisce una CEnvelope assegnandole già i valori necessari

CEnvelope(ISender Sender, java.lang.String ReceiverObjID, java.lang.String Message)
Costruisce una CEnvelope assegnandole già i valori necessari.

CEnvelope(java.lang.String StringEnvelope)
Tenta di costruire una Envelope dalla sua rappresentazione in forma di stringa.

Method Summary

java.lang.String	getMessage() Rappresentazione in forma di stringa del messaggio da inviare
IReceiver	getReceiver() Identificativo del destinatario del messaggio
ISender	getSender() Identificativo del mittente del messaggio
CEnvelopeTrace	getTraceRoute() Informazioni per la tracciabilità del messaggio.
boolean	Replay(java.lang.String Message, ISender MsgSender) Grazie alle funzionalità di tracciabilità è possibile rispondere al messaggio semplicemente indicando il messaggio di ritorno.
void	setMessage(java.lang.String msg) Rappresentazione in forma di stringa del messaggio da inviare
void	setReceiver(IReceiver rcvr) Identificativo del destinatario del messaggio
void	setReceiverByObjectID(java.lang.String sObjID) Setta come ricevente un semplice segnaposto con l'ID indicato
void	setSender(ISender sndr) Identificativo del mittente del messaggio
void	setTraceRoute(CEnvelopeTrace sndr) Informazioni per la tracciabilità del messaggio.
java.lang.String	toString() Permette di recuperare una rappresentazione in forma di stringa dell'oggetto formato:

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

CharDelimiter

protected static java.lang.String CharDelimiter

Carattere usato come delimitatore per le intestazioni dei messaggi

Constructor Detail

CEnvelope

public CEnvelope(ISender Sender,
                 IReceiver Receiver,
                 java.lang.String Message)

Costruisce una CEnvelope assegnandole già i valori necessari

CEnvelope

public CEnvelope(ISender Sender,
                 java.lang.String ReceiverObjID,
                 java.lang.String Message)

Costruisce una CEnvelope assegnandole già i valori necessari. Il Ricevente viene posto ad un oggetto di comodo con ObjectID quello indicato

CEnvelope

public CEnvelope()

Costruttore di default della busta vuota

CEnvelope

public CEnvelope(java.lang.String StringEnvelope)
          throws CCannotConvertStringToEnvelopeException

Tenta di costruire una Envelope dalla sua rappresentazione in forma di stringa. Può essere lanciata una eccezione in caso di impossibilità.

Method Detail

getTraceRoute

public CEnvelopeTrace getTraceRoute()

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

setTraceRoute

public void setTraceRoute(CEnvelopeTrace sndr)

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

getSender

public ISender getSender()

Identificativo del mittente del messaggio

setSender

public void setSender(ISender sndr)

Identificativo del mittente del messaggio

getReceiver

public IReceiver getReceiver()

Identificativo del destinatario del messaggio

setReceiver

public void setReceiver(IReceiver rcvr)

Identificativo del destinatario del messaggio

setReceiverByObjectID

public void setReceiverByObjectID(java.lang.String sObjID)

Setta come ricevente un semplice segnaposto con l'ID indicato

getMessage

public java.lang.String getMessage()

Rappresentazione in forma di stringa del messaggio da inviare

setMessage

public void setMessage(java.lang.String msg)

Rappresentazione in forma di stringa del messaggio da inviare

toString

public java.lang.String toString()

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

Overrides:

toString in class java.lang.Object

Replay

public boolean Replay(java.lang.String Message,
                      ISender MsgSender)

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.