Protocollo Reliable Messaging versione 1,1

  • Articolo

Questo argomento illustra i dettagli di implementazione di Windows Communication Foundation (WCF) per il protocollo WS-ReliableMessaging di febbraio 2007 (versione 1.1) necessario per l'interoperabilità tramite il trasporto HTTP. WCF segue la specifica WS-ReliableMessaging con i vincoli e i chiarimenti illustrati in questo argomento. Si noti che il protocollo WS-ReliableMessaging versione 1.1 viene implementato a partire da .NET Framework 3.5.

Il protocollo WS-ReliableMessaging di febbraio 2007 viene implementato in WCF da ReliableSessionBindingElement.

Per comodità, nell'argomento vengono utilizzati i ruoli seguenti:

  • Iniziatore: il client che inizia la creazione della sequenza di WS-Reliable Message.

  • Risponditore: il servizio che riceve le richieste dell'iniziatore.

In questo documento vengono utilizzati i prefissi e gli spazi dei nomi riportati nella tabella seguente.

Prefisso Spazio dei nomi
wsrm http://docs.oasis-open.org/ws-rx/wsrm/200702
netrm http://schemas.microsoft.com/ws/2006/05/rm
s http://www.w3.org/2003/05/soap-envelope
wsa http://schemas.xmlsoap.org/ws/2005/08/addressing
wsse http://docs.oasis-open.org/wss/2004/01/oasis-200401-wssecurity-secext-1.0.xsd
wsrmp http://docs.oasis-open.org/ws-rx/wsrmp/200702
netrmp http://schemas.microsoft.com/ws-rx/wsrmp/200702
wsp (WS-Policy 1.2 o WS-Policy 1.5)

Messaggistica

Creazione sequenza

WCF implementa i messaggi CreateSequence e CreateSequenceResponse per stabilire una sequenza di messaggistica affidabile. Si applicano i vincoli seguenti:

  • B1101: l'iniziatore WCF utilizza lo stesso riferimento dell'endpoint di ReplyTo, AcksTo e Offer/Endpoint del messaggio CreateSequence.

  • R1102: i riferimenti degli endpoint AcksTo, ReplyTo e Offer/Endpoint nel messaggio CreateSequence devono avere valori di indirizzo con rappresentazioni di stringa identiche in modo che corrispondano all'ottetto.

    • Prima di creare una sequenza, il risponditore WCF verifica che la parte URI dei riferimenti degli endpoint AcksTo, ReplyTo e Endpoint sia identica.

  • R1103: i riferimenti degli endpoint AcksTo, ReplyTo e Offer/Endpoint nel messaggio CreateSequence devono avere lo stesso set di parametri per riferimento.

    • WCF non impone, ma presuppone che i parametri di riferimento dei riferimenti degli endpoint AcksTo, ReplyTo e Offer/Endpoint in CreateSequence siano identici e utilizza i parametri di riferimento dal riferimento dell'endpoint ReplyTo per riconoscimenti e messaggi in sequenza opposta.

  • B1104: l'iniziatore WCF non genera l'elemento facoltativo Expires o Offer/Expires nel messaggio CreateSequence.

  • B1105: quando si accede al messaggio CreateSequence, il risponditore WCF utilizza il valore Expires dell'elemento CreateSequence come valore Expires dell'elemento CreateSequenceResponse. In caso contrario, il risponditore WCF legge e ignora i valori Expires e Offer/Expires.

  • B1106: quando si accede al messaggio CreateSequenceResponse, l'iniziatore WCF legge il valore facoltativo Expires, ma non lo utilizza.

  • B1107: l'iniziatore e il risponditore WCF generano sempre l'elemento facoltativo IncompleteSequenceBehavior negli elementi CreateSequence/Offer e CreateSequenceResponse.

  • B1108: WCF utilizza solo i valori DiscardFollowingFirstGap e NoDiscard nell'elemento IncompleteSequenceBehavior.

    • WS-ReliableMessaging utilizza il meccanismo Offer per stabilire le due sequenze correlate opposte che formano una sessione.

  • B1109: se CreateSequence contiene un elemento Offer, il risponditore unidirezionale WCF respinge la sequenza offerta rispondendo con un CreateSequenceResponse senza un elemento Accept.

  • B1110: se un risponditore Reliable Messaging respinge la sequenza offerta, l'iniziatore WCF genera errori per la sequenza appena stabilita.

  • B1111: se CreateSequence non contiene un elemento Offer, il risponditore bidirezionale WCF respinge la sequenza offerta rispondendo con un errore CreateSequenceRefused.

  • R1112: quando vengono stabilite due sequenze opposte utilizzando il meccanismo Offer, la proprietà [address] del riferimento dell'endpoint CreateSequenceResponse/Accept/AcksTo deve corrispondere all'URI di destinazione del messaggio CreateSequence, byte per byte.

  • R1113: quando vengono stabilite due sequenze opposte utilizzando il meccanismo Offer, tutti i messaggi su entrambe le sequenze dall'iniziatore al risponditore devono essere inviati allo stesso riferimento dell'endpoint.

WCF utilizza WS-ReliableMessaging per stabilire sessioni affidabili tra l'iniziatore e il risponditore. L'implementazione di WS-ReliableMessaging di WCF offre una sessione affidabile per modelli di messaggistica unidirezionali, richiesta/risposta e full duplex. Il meccanismo Offer di WS-Reliable Messaging in CreateSequence e CreateSequenceResponse consente di stabilire due sequenze opposte correlate e fornisce un protocollo della sessione idoneo per tutti gli endpoint del messaggio. Dato che WCF fornisce una garanzia di sicurezza per tale sessione, inclusa la protezione end-to-end per l'integrità della sessione, è consigliabile assicurarsi che i messaggi destinati alla stessa parte arrivino alla stessa destinazione. Ciò consente anche il "piggy-backing" degli acknowledgement della sequenza sui messaggi dell'applicazione. Pertanto, i vincoli R1102, R1112 e R1113 si applicano a WCF.

Esempio di un messaggio CreateSequence.

<s:Envelope>
  <s:Header>
    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/CreateSequence</wsa:Action>
    <wsa:MessageID>urn:uuid:949cca61-8813-42ff-ab33-18d9e3fa82fa</wsa:MessageID>
    <wsa:ReplyTo>
        <wsa:Address>http://Business456.com/clientA</wsa:Address>
    </wsa:ReplyTo>
    <wsa:To s:mustUnderstand="1">http://BusinessABC.com/serviceA</wsa:To>
  </s:Header>
  <s:Body>
    <wsrm:CreateSequence>
      <wsrm:AcksTo>
        <wsa:Address>http://Business456.com/clientA</wsa:Address>
      </wsrm:AcksTo>
      <wsrm:Offer>
        <wsrm:Identifier>urn:uuid:066b4730-fc82-458a-a5c1-210be4fb4e4e</wsrm:Identifier>
        <wsrm:Endpoint>
          <wsa:Address>http://Business456.com/clientA</wsa:Address>
        </wsrm:Endpoint>
        <wsrm:IncompleteSequenceBehavior>DiscardFollowingFirstGap</wsrm:IncompleteSequenceBehavior>
      </wsrm:Offer>
    </wsrm:CreateSequence>
  </s:Body>
</s:Envelope>

Esempio di un messaggio CreateSequenceResponse.

<s:Envelope>
  <s:Header>
    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/CreateSequenceResponse</wsa:Action>
    <wsa:RelatesTo>urn:uuid:949cca61-8813-42ff-ab33-18d9e3fa82fa</wsa:RelatesTo>
    <wsa:To s:mustUnderstand="1">http://Business456.com/clientA</wsa:To>
  </s:Header>
  <s:Body>
    <wsrm:CreateSequenceResponse>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
      <wsrm:IncompleteSequenceBehavior>DiscardFollowingFirstGap</wsrm:IncompleteSequenceBehavior>
      <wsrm:Accept>
        <wsrm:AcksTo>
          <wsa:Address>http://BusinessABC.com/serviceA</wsa:Address>
        </wsrm:AcksTo>
      </wsrm:Accept>
    </wsrm:CreateSequenceResponse>
  </s:Body>
</s:Envelope>

Chiusura di una sequenza

WCF utilizza i messaggi CloseSequence e CloseSequenceResponse per un arresto iniziato dall'origine di Reliable Messaging. La destinazione di Reliable Messaging di WCF non inizia l'arresto e l'origine di Reliable Messaging di WCF non supporta un arresto iniziato dalla destinazione di Reliable Messaging. Si applicano i vincoli seguenti:

  • B1201: l'origine di Reliable Messaging di WCF invia sempre un messaggio CloseSequence per chiudere la sequenza.

  • B1202: l'origine di Reliable Messaging attende l'acknowledgment dell'intera serie di messaggi della sequenza prima di inviare il messaggio CloseSequence.

  • B1203: l'origine di Reliable Messaging include sempre l'elemento facoltativo LastMsgNumber. Non lo include se la sequenza non contiene messaggi.

  • R1204: la destinazione di Reliable Messaging non deve iniziare l'arresto inviando un messaggio CloseSequence.

  • B1205: al ricevimento di un messaggio CloseSequence, l'origine di Reliable Messaging di WCF considera la sequenza incompleta e invia un errore.

Esempio di un messaggio CloseSequence.

<s:Envelope>
  <s:Header>
    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/CloseSequence</wsa:Action>
    <wsa:MessageID>urn:uuid:6ce1d4c3-e1c1-474f-a8c9-4210e37f7877</wsa:MessageID>
    <wsa:ReplyTo>
      <wsa:Address>http://Business456.com/clientA</wsa:Address>
    </wsa:ReplyTo>
    <wsa:To s:mustUnderstand="1">http://BusinessABC.com/serviceA</wsa:To>
  </s:Header>
  <s:Body>
    <wsrm:CloseSequence>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
      <wsrm:LastMsgNumber>30</wsrm:LastMsgNumber>
    </wsrm:CloseSequence>
  </s:Body>
</s:Envelope>

Esempio di messaggio CloseSequenceResponse:

<s:Envelope>
  <s:Header>
    <wsrm:SequenceAcknowledgement>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
      <wsrm:AcknowledgementRange Lower="1" Upper="30"></wsrm:AcknowledgementRange>
      <wsrm:Final></wsrm:Final>
      <netrm:BufferRemaining>8</netrm:BufferRemaining>
    </wsrm:SequenceAcknowledgement>
    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/CloseSequenceResponse</wsa:Action>
    <wsa:RelatesTo>urn:uuid:6ce1d4c3-e1c1-474f-a8c9-4210e37f7877</wsa:RelatesTo>
    <wsa:To s:mustUnderstand="1">http://Business456.com/clientA</wsa:To>
  </s:Header>
  <s:Body>
    <wsrm:CloseSequenceResponse>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
    </wsrm:CloseSequenceResponse>
  </s:Body>
</s:Envelope>

Terminazione della sequenza

WCF utilizza principalmente l'handshake TerminateSequence/TerminateSequenceResponse al completamento dell'handshake CloseSequence/CloseSequenceResponse. La destinazione di Reliable Messaging di WCF non inizia la terminazione e l'origine di Reliable Messaging non supporta una terminazione iniziata dalla destinazione di Reliable Messaging. Si applicano i vincoli seguenti:

  • B1301: l'iniziatore WCF invia il messaggio TerminateSequence solo al completamento corretto dell'handshake CloseSequence/CloseSequenceResponse.

  • R1302: WCF controlla che l'elemento LastMsgNumber sia coerente in tutti i messaggi CloseSequence e TerminateSequence per una data sequenza. Ciò significa che LastMsgNumber o non è presente in tutti i messaggi CloseSequence e TerminateSequence, o è presente e identico in tutti i messaggi CloseSequence e TerminateSequence.

  • B1303: al ricevimento di un messaggio TerminateSequence dopo l'handshake CloseSequence/CloseSequenceResponse, la destinazione di Reliable Messaging risponde con un messaggio TerminateSequenceResponse. Poiché l'origine di Reliable Messaging dispone dell'acknowledgement finale prima dell'invio del messaggio TerminateSequence, la destinazione di Reliable Messaging è a conoscenza della fine della sequenza e richiede immediatamente le risorse.

  • B1304: se viene ricevuto un messaggio TerminateSequence prima dell'handshake CloseSequence/CloseSequenceResponse, la destinazione di Reliable Messaging di WCF risponde con un messaggio TerminateSequenceResponse. Se la destinazione di Reliable Messaging stabilisce che non vi sono incoerenze nella sequenza, attende per il periodo di tempo specificato dalla destinazione dell'applicazione prima di richiedere le risorse, per offrire al client la possibilità di ricevere l'acknowledgement finale. In caso contrario, la destinazione di Reliable Messaging richiede immediatamente le risorse e indica alla destinazione dell'applicazione che la sequenza termina in modo dubbio generando l'evento Faulted.

Esempio di un messaggio TerminateSequence.

<s:Envelope>
  <s:Header>
    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/TerminateSequence</wsa:Action>
    <wsa:MessageID>urn:uuid:3597a398-4f3c-40f4-9335-8f1515572fdf</wsa:MessageID>
    <wsa:ReplyTo>
      <wsa:Address>http://Business456.com/clientA</wsa:Address>
    </wsa:ReplyTo>
    <wsa:To s:mustUnderstand="1">http://BusinessABC.com/serviceA</wsa:To>
  </s:Header>
  <s:Body>
    <wsrm:TerminateSequence>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
      <wsrm:LastMsgNumber>30</wsrm:LastMsgNumber>
      </wsrm:TerminateSequence>
  </s:Body>
</s:Envelope>

Esempio di messaggio TerminateSequenceResponse:

<s:Envelope>
  <s:Header>
    <wsrm:SequenceAcknowledgement>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
      <wsrm:AcknowledgementRange Lower="1" Upper="30"></wsrm:AcknowledgementRange>
      <wsrm:Final></wsrm:Final>
      <netrm:BufferRemaining>8</netrm:BufferRemaining>
    </wsrm:SequenceAcknowledgement>
    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/TerminateSequenceResponse</wsa:Action>
    <wsa:RelatesTo>urn:uuid:3597a398-4f3c-40f4-9335-8f1515572fdf</wsa:RelatesTo>
    <wsa:To s:mustUnderstand="1">://Business456.com/clientA</wsa:To>
  </s:Header>
  <s:Body>
    <wsrm:TerminateSequenceResponse>
      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
    </wsrm:TerminateSequenceResponse>
  </s:Body>
</s:Envelope>

Sequenze

Di seguito è riportato un elenco di vincoli che si applicano alle sequenze:

  • B1401: WCF genera e accede a numeri di sequenza non superiori al valore inclusivo massimo di xs:long, 9223372036854775807.

Esempio di intestazione Sequence.

<wsrm:Sequence s:mustUnderstand="1">
  <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
  <wsrm:MessageNumber>1</wsrm:MessageNumber>
</wsrm:Sequence>

Acknowledgement della richiesta

WCF utilizza l'intestazione AckRequested come meccanismo keep-alive.

Esempio di intestazione AckRequested.

<wsrm:AckRequested>
  <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
</wsrm:AckRequested>

SequenceAcknowledgement

WCF utilizza un meccanismo "piggy-back" per i riconoscimenti di sequenza forniti in WS-Reliable Messaging. Si applicano i vincoli seguenti:

  • R1601: quando vengono stabilite due sequenze opposte utilizzando il meccanismo Offer, l'intestazione SequenceAcknowledgement può essere inclusa in qualsiasi messaggio dell'applicazione trasmesso al destinatario desiderato. L'endpoint remoto deve essere in grado di accedere a un'intestazione SequenceAcknowledgement sottoposta a piggyback.

  • B1602: WCF non genera intestazioni SequenceAcknowledgement che contengono elementi Nack. WCF verifica che ogni elemento Nack contenga un numero di sequenza, ma altrimenti ignora l'elemento e il valore Nack.

Esempio di intestazione SequenceAcknowledgement.

<wsrm:SequenceAcknowledgement>
  <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
  <wsrm:AcknowledgementRange Lower="1" Upper="1"></wsrm:AcknowledgementRange>
</wsrm:SequenceAcknowledgement>

Errori WS-ReliableMessaging

Di seguito è riportato un elenco di vincoli che si applicano all'implementazione WCF degli errori di WS-ReliableMessaging. Si applicano i vincoli seguenti:

  • B1701: WCF non genera errori MessageNumberRollover.

  • B1702: su SOAP 1.2 quando l'endpoint del servizio raggiunge il limite di connessione e non è in grado di elaborare nuove connessioni, WCF genera un codice secondario dell'errore CreateSequenceRefused annidato, netrm:ConnectionLimitReached, come illustrato nell'esempio seguente.

<s:Envelope>
  <s:Header>
    <wsa:Action>http://docs.oasis-open.org/ws-rx/wsrm/200702/fault</wsa:Action>
  </s:Header>
  <s:Body>
    <s:Fault>
      <s:Code>
        <s:Value>s:Receiver</s:Value>
        <s:Subcode>
          <s:Value>wsrm:CreateSequenceRefused</s:Value>
          <s:Subcode>
            <s:Value>netrm:ConnectionLimitReached</s:Value>
          </s:Subcode>
        </s:Subcode>
      </s:Code>
      <s:Reason>
        <s:Text xml:lang="en">Server 'http://BusinessABC.com/serviceA' is too busy to process this request. Try again later.</s:Text>
      </s:Reason>
    </s:Fault>
  </s:Body>
</s:Envelope>

Errori WS-Addressing

Dato che WS-ReliableMessaging utilizza WS-Addressing, l'implementazione WS-ReliableMessaging di WCF potrebbe generare e trasmettere errori WS-Addressing. Questa sezione illustra gli errori di WS-Addressing generati e trasmessi in modo esplicito da WCF a livello di WS-ReliableMessaging:

  • B1801: WCF genera e trasmette l'errore Message Addressing Header Required quando si verifica una delle condizioni seguenti:

    • In un messaggio CreateSequence, CloseSequence o TerminateSequence manca un'intestazione MessageId.

    • In un messaggio CreateSequence, CloseSequence o TerminateSequence manca un'intestazione ReplyTo.

    • In un messaggio CreateSequenceResponse, CloseSequenceResponse o TerminateSequenceResponse manca un'intestazione RelatesTo.

  • B1802: WCF genera e trasmette l'errore Endpoint Unavailable a indicare che nessun endpoint in ascolto è in grado di elaborare la sequenza in base all'esame delle intestazioni di indirizzamento nel messaggio CreateSequence.

Composizione del protocollo

Composizione con WS-Addressing

WCF supporta due versioni di WS-Addressing: WS-Addressing 2004/08 [WS-ADDR] e W3C WS-Addressing 1.0 Raccomandazioni per [WS-ADDR-CORE] e [WS-ADDR-SOAP].

Anche se la specifica WS-ReliableMessaging menziona solo WS-Addressing 2004/08, non limita la versione WS-Addressing da utilizzare. Di seguito è riportato un elenco di vincoli che si applicano a WCF:

  • R2101: sia WS-Addressing 2004/08 che WS-Addressing 1.0 possono essere utilizzati con WS-Reliable Messaging.

  • R2102: è necessario utilizzare una sola versione di WS-Addressing in una data sequenza di WS-Reliable Messaging o in una coppia di sequenze opposte correlate tramite il meccanismo Offer.

Composizione con SOAP

WCF supporta l'utilizzo sia di SOAP 1.1 che di SOAP 1.2 con WS-Reliable Messaging.

Composizione con WS-Security e WS-SecureConversation

WCF fornisce protezione per le sequenze di WS-ReliableMessaging utilizzando trasporto sicuro (HTTPS), composizione con WS-Security e composizione con WS-Secure Conversation. Il protocollo WS-Reliable Messaging 1.1, WS-Security 1.1 e il protocollo WS-SecureConversation 1.3 devono essere utilizzati insieme. Di seguito è riportato un elenco di vincoli che si applicano a WCF:

  • R2301: per proteggere l'integrità di una sequenza di WS-ReliableMessaging oltre all'integrità e alla riservatezza dei singoli messaggi, WCF richiede l'utilizzo di WS-Secure Conversation.

  • R2302: prima di stabilire l'una o più sequenze di WS-ReliableMessaging, è necessario stabilire una sessione di AWS-Secure Conversation.

  • R2303: se la durata della sequenza di WS-Reliable Messaging supera la durata della sessione WS-SecureConversation, è necessario rinnovare il SecurityContextToken stabilito tramite WS-SecureConversation utilizzando l'associazione WS-Secure Conversation Renewal corrispondente.

  • B2304: la sequenza di WS-ReliableMessaging o una coppia di sequenze opposte correlate sono sempre associate a una singola sessione di WS-SecureConversation.

  • R2305: se composto con WS-Secure Conversation, il risponditore di WCF richiede che il messaggio CreateSequence contenga l'elemento wsse:SecurityTokenReference e l'intestazione wsrm:UsesSequenceSTR.

Esempio di intestazione UsesSequenceSTR.

<wsrm:UsesSequenceSTR></wsrm:UsesSequenceSTR>

Composizione con sessioni SSL/TLS

WCF non supporta la composizione con sessioni SSL/TLS:

  • B2401: WCF non genera l'intestazione wsrm:UsesSequenceSSL.

  • R2402: un iniziatore Reliable Messaging non deve inviare un messaggio CreateSequence con l'intestazione wsrm:UsesSequenceSSL a un risponditore WCF.

Composizione con WS-Policy

WCF supporta due versioni di WS-Policy: WS-Policy 1.2 e WS-Policy 1.5.

Asserzione di WS-Policy relativa a WS-ReliableMessaging

WCF utilizza l'asserzione di WS-Policy wsrm:RMAssertion relativa a WS-ReliableMessaging per descrivere le funzionalità degli endpoint. Di seguito è riportato un elenco di vincoli che si applicano a WCF:

  • B3001: WCF allega l'asserzione di WS-Policy wsrmn:RMAssertion agli elementi wsdl:binding. WCF supporta gli allegati sia agli elementi wsdl:binding che agli elementi wsdl:port.

  • B3002: WCF non genera mai il tag wsp:Optional.

  • B3003: quando si accede all'asserzione di WS-Policy wsrmp:RMAssertion, WCF ignora il tag wsp:Optional e considera obbligatorio il criterio WS-RM.

  • R3004: poiché WCF non esegue la composizione con sessioni SSL/TLS, WCF non accetta il criterio che specifica wsrmp:SequenceTransportSecurity.

  • B3005: WCF genera sempre l'elemento wsrmp:DeliveryAssurance.

  • B3006: WCF specifica sempre la garanzia di recapito wsrmp:ExactlyOnce.

  • B3007: WCF genera e legge le proprietà seguenti dell'asserzione WS-ReliableMessaging e fornisce un controllo su di esse in ReliableSessionBindingElement di WCF:

    • netrmp:InactivityTimeout

    • netrmp:AcknowledgementInterval

    Esempio di RMAssertion.

    <wsrmp:RMAssertion>
  <wsp:Policy>
    <wsrmp:SequenceSTR/>
    <wsrmp:DeliveryAssurance>
      <wsp:Policy>
        <wsrmp:ExactlyOnce/>
        <wsrmp:InOrder/>
      </wsp:Policy>
    </wsrmp:DeliveryAssurance>
  </wsp:Policy>
  <netrmp:InactivityTimeout Milliseconds="600000"/>
  <netrmp:AcknowledgementInterval Milliseconds="200"/>
</wsrmp:RMAssertion>

Estensione di WS-ReliableMessaging per il controllo del flusso

WCF utilizza l'estendibilità di WS-ReliableMessaging per offrire un controllo facoltativo aggiuntivo più rigido sul flusso di messaggi della sequenza.

Il controllo del flusso è abilitato impostando la proprietà ReliableSessionBindingElement.FlowControlEnabled su true. Di seguito è riportato un elenco di vincoli che si applicano a WCF:

  • B4001: quando il controllo del flusso di Reliable Messaging è attivato, WCF genera un elemento netrm:BufferRemaining nell'estendibilità dell'elemento dell'intestazione SequenceAcknowledgement, come illustrato nell'esempio seguente.

    <wsrm:SequenceAcknowledgement>
  <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>
  <wsrm:AcknowledgementRange Upper="1" Lower="1"/>
  <netrm:BufferRemaining>8</netrm:BufferRemaining>
</wsrm:SequenceAcknowledgement>

  • B4002: anche quando il controllo del flusso di Reliable Messaging è attivato, WCF non richiede un elemento netrm:BufferRemaining nell'intestazione SequenceAcknowledgement.

  • B4003: la destinazione di Reliable Messaging di WCF utilizza netrm:BufferRemaining per indicare quanti messaggi nuovi è in grado di memorizzare nel buffer.

  • B4004: quando il controllo del flusso di Reliable Messaging è attivato, l'origine di Reliable Messaging di WCF utilizza il valore di netrm:BufferRemaining per limitare la trasmissione dei messaggi.

  • B4005: WCF genera valori interi netrm:BufferRemaining compresi tra 0 e 4096 inclusi e legge valori interi compresi tra 0 e il valore 214748364 xs:int di maxInclusive inclusi.

Modelli di scambio dei messaggi

In questa sezione viene descritto il comportamento di WCF quando WS-ReliableMessaging viene utilizzato per diversi modelli di scambio di messaggi. Per ogni modello di scambio di messaggi, vengono presi in considerazione i due scenari di distribuzione seguenti:

  • Iniziatore non indirizzabile: l'iniziatore si trova dietro a un firewall; il risponditore può recapitare messaggi all'iniziatore solo su risposte HTTP.

  • Iniziatore indirizzabile: le richieste HTTP possono essere inviate sia all'iniziatore che al risponditore. In altre parole, è possibile stabilire due connessioni HTTP opposte.

Iniziatore unidirezionale, non indirizzabile

Binding

WCF fornisce un modello di scambio di messaggi unidirezionale utilizzando una sequenza su un canale HTTP. WCF utilizza le richieste HTTP per trasmettere tutti i messaggi dall'iniziatore al risponditore e le risposte HTTP per trasmettere tutti i messaggi dal risponditore all'iniziatore.

Scambio CreateSequence

L'iniziatore WCF trasmette un messaggio CreateSequence senza alcun elemento Offer su una richiesta HTTP e attende il messaggio CreateSequenceResponse sulla risposta HTTP. Il risponditore WCF crea una sequenza e trasmette il messaggio CreateSequenceResponse senza alcun elemento Accept sulla risposta HTTP.

SequenceAcknowledgement

L'iniziatore WCF elabora i riconoscimenti sulla risposta di tutti i messaggi tranne il messaggio CreateSequence e i messaggi di errore. Il risponditore WCF trasmette sempre un riconoscimento autonomo sulla risposta HTTP a tutte le sequenze e ai messaggi AckRequested.

Scambio CloseSequence

L'iniziatore WCF trasmette un messaggio CloseSequence su una richiesta HTTP e attende il messaggio CreateSequenceResponse sulla risposta HTTP. Il risponditore WCF trasmette il messaggio CloseSequenceResponse sulla risposta HTTP.

Scambio TerminateSequence

L'iniziatore WCF trasmette un messaggio TerminateSequence su una richiesta HTTP e attende il messaggio TerminateSequenceResponse sulla risposta HTTP. Il risponditore WCF trasmette il messaggio TerminateSequenceResponse sulla risposta HTTP.

Iniziatore unidirezionale, indirizzabile

Binding

WCF fornisce un modello unidirezionale di scambio di messaggi che utilizza una sola sequenza su un canale HTTP in ingresso e uno in uscita. WCF utilizza le richieste HTTP per trasmettere tutti i messaggi. Tutte le risposte HTTP hanno un corpo vuoto e un codice di stato HTTP 202.

Scambio CreateSequence

L'iniziatore WCF trasmette un messaggio CreateSequence senza alcun elemento Offer su una richiesta HTTP. Il risponditore WCF crea una sequenza e trasmette il messaggio CreateSequenceResponse senza alcun elemento Accept su una richiesta HTTP.

Iniziatore duplex, indirizzabile

Binding

WCF fornisce un modello di scambio di messaggi bidirezionale completamente asincrono utilizzando due sequenze su un canale HTTP in ingresso e su uno in uscita. Questo modello di scambio può essere combinato con il modello di scambio di messaggi dell'iniziatore Request/Reply, Addressable in modo limitato. WCF utilizza le richieste HTTP per trasmettere tutti i messaggi. Tutte le risposte HTTP hanno un corpo vuoto e un codice di stato HTTP 202.

Scambio CreateSequence

L'iniziatore WCF trasmette un messaggio CreateSequence senza alcun elemento Offer su una richiesta HTTP. Il risponditore WCF controlla che CreateSequence abbia un elemento Offer, quindi crea una sequenza e trasmette il messaggio CreateSequenceResponse con un elemento Accept.

Durata della sequenza

WCF tratta le due sequenze come una sessione completamente duplex.

Quando si genera un errore che genera un errore in una sequenza, WCF prevede che l'endpoint remoto generi errori in entrambe le sequenze. Dopo la lettura di un errore che genera un errore in una sequenza, WCF genera errori in entrambe le sequenze.

WCF può chiudere la sua sequenza in uscita e continuare a elaborare i messaggi nella sua sequenza in entrata. Per contro, WCF può elaborare la chiusura della sequenza in entrata e continuare a inviare messaggi nella sua sequenza in uscita.

Iniziatore request/reply e unidirezionale, non indirizzabile

Binding

WCF fornisce un modello di scambio di messaggi unidirezionale e richiesta-risposta usando due sequenze su un canale HTTP. WCF utilizza le richieste HTTP per trasmettere tutti i messaggi dall'iniziatore al risponditore e le risposte HTTP per trasmettere tutti i messaggi dal risponditore all'iniziatore.

Scambio CreateSequence

L'iniziatore WCF trasmette un messaggio CreateSequence senza alcun elemento Offer su una richiesta HTTP e attende il messaggio CreateSequenceResponse sulla risposta HTTP. Il risponditore WCF crea una sequenza e trasmette il messaggio CreateSequenceResponse con un elemento Accept sulla risposta HTTP.

Messaggio unidirezionale

Per completare correttamente uno scambio di messaggi unidirezionale, l'iniziatore WCF trasmette un messaggio della sequenza di richiesta sulla richiesta HTTP e riceve un messaggio SequenceAcknowledgement autonomo sulla risposta HTTP. SequenceAcknowledgement deve riconoscere il messaggio trasmesso.

Il risponditore WCF può rispondere alla richiesta con un riconoscimento, un errore o una risposta con un corpo vuoto e un codice di stato HTTP 202.

Messaggi bidirezionali

Per completare correttamente un protocollo di scambio di messaggi bidirezionale, l'iniziatore WCF trasmette un messaggio di sequenza di richiesta sulla richiesta HTTP e riceve un messaggio di sequenza di risposta sulla risposta HTTP. La risposta deve contenere un SequenceAcknowledgement che riconosce che il messaggio della sequenza di richiesta è stato trasmesso.

Il risponditore WCF può rispondere alla richiesta con una risposta dell'applicazione, un errore o una risposta con un corpo vuoto e un codice di stato HTTP 202.

A causa della presenza di messaggi unidirezionali e del tempo delle risposte dell'applicazione, il numero di sequenza del messaggio della sequenza di richiesta e il numero di sequenza del messaggio di risposta non hanno alcuna correlazione.

Nuovi tentativi di risposte

WCF si basa sulla correlazione richiesta/risposta HTTP per la correlazione del protocollo di scambio di messaggi bidirezionale. Di conseguenza, l'iniziatore WCF non smette di tentare un messaggio della sequenza di richiesta quando tale messaggio viene riconosciuto, ma piuttosto quando la risposta HTTP contiene un SequenceAcknowledgement, una risposta dell'applicazione o un errore. Il risponditore WCF ritenta le risposte sulla risposta HTTP della richiesta alla quale è correlata la risposta.

Scambio CloseSequence

Dopo avere ricevuto tutti i messaggi della sequenza di risposta e i riconoscimenti per tutti i messaggi della sequenza di richiesta unidirezionali, l'iniziatore WCF trasmette un messaggio CloseSequence per la sequenza di richieste su una richiesta HTTP e attende CloseSequenceResponse sulla risposta HTTP.

Se la sequenza di richiesta viene chiusa in modo implicito, viene chiusa anche la sequenza di risposta. Ciò significa che l'iniziatore WCF include SequenceAcknowledgement finale della sequenza di risposte sul messaggio CloseSequence e che la sequenza di risposta non ha uno scambio CloseSequence.

Il risponditore WCF assicura che tutte le risposte vengano riconosciute e trasmette il messaggio CloseSequenceResponse sulla risposta HTTP.

Scambio TerminateSequence

Dopo la ricezione del messaggio CloseSequenceResponse, l'iniziatore WCF trasmette un messaggio TerminateSequence per la sequenza di richieste su una richiesta HTTP e attende TerminateSequenceResponse sulla risposta HTTP.

Analogamente allo scambio CloseSequence, la terminazione della sequenza di richiesta in modo implicito termina la sequenza di risposta. Ciò significa che l'iniziatore WCF include SequenceAcknowledgement finale della sequenza di risposta sul messaggio TerminateSequence e che la sequenza di risposta non ha uno scambio TerminateSequence.

Il risponditore WCF trasmette il messaggio TerminateSequenceResponse sulla risposta HTTP.

Iniziatore request/reply, indirizzabile

Binding

WCF fornisce un modello di scambio di messaggi richiesta/risposta utilizzando due sequenze su un canale HTTP in ingresso e su uno in uscita. Questo modello di scambio può essere combinato con il modello di scambio di messaggi dell'iniziatore Duplex, Addressable in modo limitato. WCF utilizza le richieste HTTP per trasmettere tutti i messaggi. Tutte le risposte HTTP hanno un corpo vuoto e un codice di stato HTTP 202.

Scambio CreateSequence

L'iniziatore WCF trasmette un messaggio CreateSequence senza alcun elemento Offer su una richiesta HTTP. Il risponditore WCF controlla che CreateSequence abbia un elemento Offer, quindi crea una sequenza e trasmette il messaggio CreateSequenceResponse con un elemento Accept.

Correlazione request/reply

Quanto riportato di seguito si applica a tutte le richieste e le risposte correlate:

  • WCF controlla che tutti i messaggi di richiesta dell'applicazione contengano un riferimento all'endpoint ReplyTo e un MessageId.

  • WCF applica il riferimento dell'endpoint locale come ReplyTo di ogni messaggio di richiesta dell'applicazione. Il riferimento dell'endpoint locale è CreateSequence del messaggio ReplyTo per l'iniziatore e CreateSequence del messaggio To per il risponditore.

  • WCF controlla che i messaggi di richiesta in entrata contengano un MessageId e un ReplyTo.

  • WCF controlla che l'URI di riferimento dell'endpoint ReplyTo di tutti i messaggi di richiesta dell'applicazione corrisponda al riferimento dell'endpoint locale come definito in precedenza.

  • WCF controlla che tutte le risposte contengano le intestazioni RelatesTo e To corrette, in conformità con le regole di correlazione richiesta-risposta wsa.