Canale di riconoscimento HTTP

  • Articolo

Il canale di riconoscimento HTTP è un esempio di canale su più livelli in grado di modificare il modello di messaggistica unidirezionale, consentendo a un servizio di riconoscere o rifiutare i messaggi in arrivo anziché inviare automaticamente un riconoscimento al momento della ricezione. Il canale di riconoscimento HTTP consente inoltre al servizio di ritardare il riconoscimento fino a quando non è possibile garantire a livello aziendale che il messaggio verrà elaborato.

Dimostrazione

ReceiveContext, esempio relativo a un canale su più livelli (canale di riconoscimento HTTP).

Discussione

Il canale di riconoscimento HTTP implementa ReceiveContext per determinare la struttura del modello di messaggistica request/reply HTTP, trasformandolo in un modello unidirezionale con riconoscimento ritardato. Utilizzando questo nuovo modello, un servizio può garantire l'elaborazione dei messaggi inviando un riconoscimento sotto forma di codice di stato HTTP di OK (200) senza bloccare il client fino a quando l'elaborazione dei messaggi non è stata completata oppure può inviare un messaggio di errore al client sotto forma di codice di stato HTTP Errore server interno (500). Ad esempio, un servizio può inviare un riconoscimento dopo avere scritto un messaggio in una coda, quindi continuare ad elaborare il messaggio in modo asincrono. In questo scenario, è possibile garantire a un client che i messaggi sono stati elaborati almeno una volta dal servizio, se ha rispedito ogni messaggio fino a ricevere una conferma di riconoscimento dal servizio. È importante notare che, se un servizio richiede una rapida elaborazione asincrona di messaggi in HTTP senza alcuna garanzia di elaborazione dei messaggi, OneWayBindingElement è una scelta più appropriata.

ReceiveContext viene utilizzato per conservare il messaggio mentre si determina se può essere elaborato a livello di servizio. La capacità di un servizio di elaborare correttamente il messaggio viene indicata con una chiamata del metodo Complete nell'oggetto ReceiveContext che invia un codice di stato HTTP di OK e se il servizio è in grado di elaborare il messaggio viene indicata con una chiamata al metodo Abandon nell'oggetto ReceiveContext, che invia un codice di stato HTTP Errore interno del server.

In questo esempio, il client richiede l'elaborazione di informazioni inviando un ID dipendente. Alla fine del servizio, se l'ID dipendente ricevuto è superiore a 50, il servizio restituisce al client un codice di stato HTTP 500 (Errore server interno); in caso contrario, si parte dal presupposto che l'elaborazione possa essere effettuata correttamente e al client viene inviato un codice di stato HTTP 200 (OK).

Per impostare, compilare ed eseguire l'esempio

  1. Aprire Visual Studio 2010 con privilegi di amministratore.

  2. Aprire la soluzione HttpAckChannel.

  3. Avviare una nuova istanza del progetto Service facendo clic con il pulsante destro del mouse sul progetto in Esplora soluzioni, quindi selezionando Debug, Avvia nuova istanza nel menu di scelta rapida.

  4. Avviare una nuova istanza del progetto Client facendo clic con il pulsante destro del mouse sul progetto in Esplora soluzioni, quindi selezionando Debug e Avvia nuova istanza nel menu di scelta rapida.

  5. Una volta avviato il servizio, premere INVIO nella finestra del client per consentire al client di inviare un messaggio al servizio.

  6. Il primo messaggio viene elaborato nel servizio e restituisce un codice di stato HTTP di OK al client.

  7. Il secondo messaggio è relativo alla mancata riuscita dell'operazione e restituisce un codice di stato HTTP Errore server interno al client, che genera un'eccezione CommunicationException nel client.

Ee960152.Important(it-it,VS.100).gif Nota:
È possibile che gli esempi siano già installati nel computer. Verificare la directory seguente (impostazione predefinita) prima di continuare.

<UnitàInstallazione>: \WF_WCF_Samples

Se questa directory non esiste, andare alla pagina relativa agli esempi di Windows Communication Foundation (WCF) e Windows Workflow Foundation (WF) per .NET Framework 4 per scaricare tutti gli esempi di Windows Communication Foundation (WCF) e WF. Questo esempio si trova nella directory seguente.

<UnitàInstallazione>:\WF_WCF_Samples\WCF\Extensibility\Channels\HttpAckChannel