Utilizzo delle attività di messaggistica

Articolo
04/18/2011

Le informazioni contenute in questo argomento sono valide per Windows Workflow Foundation 4.

Le attività di messaggistica consentono ai flussi di lavoro di inviare e ricevere messaggi WCF. Aggiungendo attività di messaggistica a un flusso di lavoro, è possibile modellare qualsiasi modello di scambio dei messaggi con la complessità desiderata.

Modelli di scambio dei messaggi

Esistono tre modelli di scambio dei messaggi di base.

Datagramma: se si utilizza il modello di scambio dei messaggi di tipo datagramma, il client invia un messaggio al servizio, tuttavia quest'ultimo non risponde. Questo tipo di modello è talvolta denominato "Fire and Forget". Tale scambio richiede una conferma fuori banda di recapito con esito positivo. Il messaggio potrebbe infatti andare perso durante il transito e non raggiungere mai il servizio. Se il client invia correttamente un messaggio, non c'è garanzia che esso sia stato ricevuto dal servizio. Il datagramma è un blocco predefinito fondamentale per la messaggistica in quanto è possibile compilare modelli di scambio dei messaggi personalizzati sulla base di esso.
Richiesta-risposta: se si utilizza il modello di scambio dei messaggi di tipo richiesta-risposta, il client invia un messaggio al servizio, il servizio esegue l'elaborazione necessaria e quindi invia una risposta al client. Il modello è costituito da coppie richiesta-risposta. Esempi di chiamate richiesta-risposta sono le chiamate RPC (Remote Procedure Call) e le richieste GET del browser. Questo modello è anche noto come half-duplex.
Duplex: se si utilizza il modello di scambio dei messaggi di tipo duplex, il client e il servizio possono scambiare messaggi tra loro in qualsiasi ordine. Tale modello è simile a una conversazione telefonica, in cui ogni parola pronunciata è un messaggio.

Le attività di messaggistica consentono di implementare uno o più dei modelli di scambio dei messaggi di base nonché modelli di qualsiasi complessità.

Attività di messaggistica

.NET Framework versione 4 definisce le attività di messaggistica seguenti:

Send- Utilizzare l'attività Send per inviare un messaggio.
SendReply - Utilizzare l'attività SendReply per inviare una risposta a un messaggio ricevuto. Questa attività viene utilizzata dai servizi flusso di lavoro in caso di implementazione di un modello di scambio dei messaggi di tipo request/reply.
Receive- Utilizzare l'attività Receive per ricevere un messaggio.
ReceiveReply- Utilizzare l'attività ReceiveReply per ricevere un messaggio di risposta. Questa attività viene utilizzata dai client dei servizi flusso di lavoro in caso di implementazione di un modello di scambio dei messaggi di tipo request/reply.

Attività di messaggistica e modelli di scambio dei messaggi

Un modello di scambio dei messaggi di tipo datagramma prevede l'invio di un messaggio da parte di un client e la ricezione del messaggio da parte di un servizio. Se il client è un flusso di lavoro, utilizzare un'attività Send per inviare il messaggio. Per ricevere il messaggio in un flusso di lavoro, utilizzare un'attività Receive. Le attività Send e Receive dispongono ognuna di una proprietà denominata Content. Questa proprietà contiene i dati che vengono inviati o ricevuti. Quando si implementa il modello di scambio dei messaggi di tipo richiesta-risposta, sia il client sia il servizio utilizzano coppie di attività. Il client utilizza un'attività Send per inviare il messaggio e un'attività ReceiveReply per ricevere la risposta dal servizio. Queste due attività sono associate tra loro mediante la proprietà Request. Questa proprietà viene impostata sull'attività Send che ha inviato il messaggio originale. Il servizio utilizza inoltre una coppia di attività associate: Receive e SendReply. Queste due attività sono associate mediante la proprietà Request. Questa proprietà viene impostata sull'attività Receive che ha ricevuto il messaggio originale. Le attività ReceiveReply e SendReply, come Send e Receive, consentono di inviare un'istanza di Message o un tipo di contratto di messaggio.

Poiché i flussi di lavoro sono a esecuzione prolungata, è importante per il modello di comunicazione di tipo duplex supportare anche le conversazioni con esecuzione prolungata. Per supportare questo tipo di conversazioni, i client che iniziano la conversazione devono fornire al servizio una possibilità di richiamarlo in un secondo momento quando i dati diventano disponibili. Ad esempio, una richiesta di ordine di acquisto viene inviata per l'approvazione da parte del responsabile, tuttavia potrebbe essere elaborata per un giorno, una settimana o perfino un anno. Il flusso di lavoro che gestisce l'approvazione degli ordini di acquisto deve poter riprendere una volta ottenuta l'approvazione. Questo modello di comunicazione di tipo duplex è supportato in flussi di lavoro che utilizzano la correlazione. Per implementare un modello duplex, utilizzare le attività Send e Receive. Nell'attività Receive, inizializzare una correlazione utilizzando il valore della chiave speciale di CallbackHandleName. Nell'attività Send impostare l'handle di correlazione in questione come valore della proprietà CorrelatesWith. Per ulteriori informazioni, vedere Duplex durevole.

Nota:
L'implementazione di flusso di lavoro del modello duplex con correlazione di callback ("duplex durevole") è destinata alle conversioni con esecuzione prolungata. Si tratta di un'implementazione diversa dal duplex WCF con contratti di callback, in cui la conversione è con esecuzione breve.

Formattazione dei messaggi e attività di messaggistica

Le attività Receive e ReceiveReply dispongono di una proprietà denominata Content. Questa proprietà è di tipo ReceiveContent e rappresenta dati ricevuti dall'attività Receive o ReceiveReply. .NET Framework definisce due classi correlate chiamate RecieveMessageContent e ReceiveParametersContent, le quali derivano entrambe da ReceiveContent. Nell'attività Receive o ReceiveReply impostare la proprietà Content su un'istanza di uno di questi tipi per ricevere i dati in un servizio flusso di lavoro. Il tipo da utilizzare dipende da quello dei dati ricevuti dall'attività. Se l'attività riceve un oggetto Message o un tipo di contratto di messaggio, utilizzare ReceiveMessageContent. Se l'attività riceve un set di tipi XML o di contratto dati serializzabili, utilizzare ReceiveParametersContent. ReceiveParametersContent consente di inviare più parametri, mentre ReceiveMessageContent consente di inviare solo un oggetto, il messaggio (o il tipo di contratto di messaggio).

Nota:
ReceiveMessageContent può essere inoltre utilizzato con un singolo tipo XML o di contratto dati serializzabile. La differenza tra l'utilizzo di ReceiveParametersContent con un solo parametro e l'oggetto passato direttamente a RecieveMessageContent è rappresentata dal formato wire. Viene eseguito il wrapping del contenuto del parametro in un elemento XML corrispondente al nome dell'operazione, nonché il wrapping dell'oggetto serializzato in un elemento XML utilizzando il nome del parametro (ad esempio, `<Echo><msg>Hello, World</msg></Echo>`). Non viene eseguito il wrapping del contenuto del messaggio in base al nome dell'operazione. Al contrario, l'oggetto serializzato viene inserito in un elemento XML che utilizza il nome del tipo XML qualificato (ad esempio, `<string>Hello, World</string>`).

Nota:

ReceiveMessageContent può essere inoltre utilizzato con un singolo tipo XML o di contratto dati serializzabile. La differenza tra l'utilizzo di ReceiveParametersContent con un solo parametro e l'oggetto passato direttamente a RecieveMessageContent è rappresentata dal formato wire. Viene eseguito il wrapping del contenuto del parametro in un elemento XML corrispondente al nome dell'operazione, nonché il wrapping dell'oggetto serializzato in un elemento XML utilizzando il nome del parametro (ad esempio, <Echo><msg>Hello, World</msg></Echo>). Non viene eseguito il wrapping del contenuto del messaggio in base al nome dell'operazione. Al contrario, l'oggetto serializzato viene inserito in un elemento XML che utilizza il nome del tipo XML qualificato (ad esempio, <string>Hello, World</string>).

Le attività Send e SendReply dispongono inoltre di una proprietà denominata Content. Questa proprietà è di tipo SendContent e rappresenta dati inviati dall'attività Send o SendReply. .NET Framework definisce due tipi correlati chiamati SendMessageContent e SendParametersContent, i quali derivano entrambi da SendContent. Nell'attività Send o SendReply impostare la proprietà Content su un'istanza di uno di questi tipi per inviare dati da un servizio flusso di lavoro. Il tipo da utilizzare dipende da quello dei dati inviati dall'attività. Se l'attività invia un oggetto Message o un tipo di contratto di messaggio, utilizzare SendMessageContent. Se l'attività invia un tipo di contratto dati, utilizzare SendParametersContent. SendParametersContent consente di inviare più parametri, mentre SendMessageContent consente di inviare un oggetto, il messaggio (o il tipo di contratto di messaggio).

Ai fini della programmazione in modo imperativo con le attività di messaggistica, si utilizzano gli elementi generici InArgument e OutArgument per eseguire il wrapping degli oggetti assegnati al messaggio o alle proprietà dei parametri delle attività Send, SendReply, Receive e ReceiveReply. Utilizzare InArgument per le attività Send e SendReply e OutArgument per le attività Receive e ReceiveReply. Gli argomenti In vengono utilizzati con le attività di invio perché i dati vengono passati nelle attività. Gli argomenti Out vengono utilizzati con le attività di ricezione perché i dati vengono passati all'esterno delle attività, come illustrato nell'esempio seguente.

Receive reserveSeat = new Receive
{ 
    ... 
    Content = new ReceiveParametersContent
    {
        Parameters =
        {
            { "ReservationInfo", new OutArgument<ReservationRequest>(reservationInfo) }
        }
    }
};
SendReply reserveSeat = new SendReply
{ 
    ... 
    Request = reserveSeat,
    Content = new SendParametersContent
    {
        Parameters =
        {
            { "ReservationId", new InArgument<string>(reservationId) }
        }
    },
};

Quando si implementa un servizio flusso di lavoro che definisce un'operazione di richiesta-risposta che restituisce void, è necessario creare un'istanza di un'attività SendReply e impostare la proprietà Content su un'istanza vuota di uno dei tipi di contenuto (SendMesageContent o SendParametersContent), come illustrato nell'esempio seguente.

Receive rcv = new Receive()
{
ServiceContractName = "IService",
OperationName = "NullReturningContract",
Content = new ReceiveParametersContent( new Dictionary<string, OutArgument>() { { "message", new OutArgument<string>() } } )
};
SendReply sr = new SendReply()
{
Request = rcv
   Content = new SendParametersContent();
};

Aggiungi riferimento al servizio

Quando si chiama un servizio flusso di lavoro da un'applicazione di flusso di lavoro, Visual Studio 2010 genera attività di messaggistica personalizzate che incapsulano le attività Send e ReceiveReply utilizzate in genere in un modello di scambio dei messaggi di tipo request/reply. Per utilizzare questa funzionalità, fare clic con il pulsante destro del mouse sul progetto client in Visual Studio 2010 e scegliere Aggiungi riferimento al servizio. Digitare l'indirizzo di base del servizio nell'apposita casella e fare clic su Vai. I servizi disponibili verranno visualizzati nella casella Servizi. Espandere il nodo del servizio per visualizzare i contratti supportati. Selezionare il contratto che si desidera chiamare per visualizzare l'elenco di operazioni disponibili nella casella Operazioni. Sarà quindi possibile specificare lo spazio dei nomi per l'attività generata e fare clic su OK. Verrà visualizzata una finestra di dialogo indicante che l'operazione è stata completata correttamente e che le attività personalizzate generate verranno inserite nella casella degli strumenti dopo aver ricompilato il progetto. Esiste una attività per ogni operazione definita nel contratto di servizio. Dopo avere ricompilato il progetto è possibile trascinare le attività personalizzate nel flusso di lavoro e impostare le eventuali proprietà necessarie nell'apposita finestra.

Modelli di attività di messaggistica

Per semplificare la configurazione di un modello di scambio dei messaggi di tipo richiesta-risposta nel client e nel servizio, Visual Studio offre due modelli di attività di messaggistica. ReceiveAndSendReply è utilizzato per il servizio e SendAndReceiveReply per il client. In entrambi i casi i modelli aggiungono le attività di messaggistica appropriate al flusso di lavoro. Nel servizio, ReceiveAndSendReply aggiunge un'attività Receive seguita da un'attività SendReply. La proprietà Request viene impostata automaticamente sull'attività Receive. Nel client, SendAndReceiveReply aggiunge un'attività Send seguita da un'attività ReceiveReply. La proprietà Request viene impostata automaticamente sull'attività Send. Per utilizzare questi modelli, è sufficiente trascinare il modello appropriato nel flusso di lavoro.

Transazioni e attività di messaggistica

Quando si effettua una chiamata a un servizio flusso di lavoro potrebbe essere utile propagare una transazione all'operazione del servizio. A tale scopo, inserire l'attività Receive all'interno di un'attività TransactedReceiveScope. L'attività TransactedReceiveScope contiene un'attività Receive e un corpo. La transazione propagata al servizio rimane di ambiente in tutta l'esecuzione del corpo di TransactedReceiveScope. La transazione viene completata quando viene completata l'esecuzione del corpo. Per ulteriori informazioni su flussi di lavoro e transazioni, vedere Transazioni del flusso di lavoro.

Condividi tramite