Aggiornamenti flusso personalizzati
I trasporti orientati al flusso, quali TCP e named pipe, operano su un flusso continuo di byte tra il client e il server. Questo flusso viene realizzato da un oggetto Stream. In un aggiornamento flusso, il client desidera aggiungere un livello di protocollo facoltativo allo stack di canali e chiede all'altra estremità del canale di comunicazione di farlo. L'aggiornamento flusso consiste nel sostituire l'oggetto Stream originale con un oggetto aggiornato.
È, ad esempio, possibile creare un flusso di compressione direttamente all'inizio del flusso di trasporto. In questo caso, la classe di trasporto Stream originale viene sostituita con una classe che esegue il wrapping della classe di compressione Stream sull'originale.
È possibile applicare più aggiornamenti flusso, ognuno dei quali esegue il wrapping del precedente.
Funzionamento degli aggiornamenti flusso
Il processo di aggiornamento flusso include quattro componenti.
Un iniziatore del flusso di aggiornamento avvia il processo: in fase di esecuzione, può inviare all'altra estremità della connessione una richiesta di aggiornamento del livello di trasporto del canale.
Un acceptor del flusso di aggiornamento esegue l'aggiornamento: in fase di esecuzione, riceve la richiesta di aggiornamento dall'altro computer e, se possibile, accetta l'aggiornamento.
Un provider di aggiornamento crea l'iniziatore sul client e l'acceptor sul server.
Un elemento di binding di aggiornamento flusso viene aggiunto ai binding sul servizio e sul client e crea il provider in fase di esecuzione.
Si noti che, nel caso di più aggiornamenti, iniziatore e acceptor incapsulano macchine a stati da imporre, le cui transizioni di aggiornamento sono valide per ogni avvio.
Come implementare un aggiornamento flusso
Windows Communication Foundation (WCF) offre quattro classi abstract che è possibile implementare:
Per implementare un aggiornamento flusso personalizzato, eseguire le operazioni seguenti. In questa procedura viene implementato un processo di aggiornamento flusso minimo sui computer client e server.
Creare una classe che implementi StreamUpgradeInitiator.
Eseguire l'override del metodo InitiateUpgrade per accettare il flusso da aggiornare e restituire il flusso aggiornato. Questo metodo funziona in modo sincrono; sono disponibili metodi analoghi per avviare l'aggiornamento in modo asincrono.
Eseguire l'override del metodo GetNextUpgrade per ricercare aggiornamenti aggiuntivi.
Creare una classe che implementi StreamUpgradeAcceptor.
Eseguire l'override del metodo AcceptUpgrade per accettare il flusso da aggiornare e restituire il flusso aggiornato. Questo metodo funziona in modo sincrono; sono disponibili metodi analoghi per accettare l'aggiornamento in modo asincrono.
Eseguire l'override del metodo CanUpgrade per determinare se l'aggiornamento richiesto è supportato da questo acceptor di aggiornamento in questo punto del processo di aggiornamento.
Creare una classe che implementi StreamUpgradeProvider. Eseguire l'override dei metodi CreateUpgradeAcceptor e CreateUpgradeInitiator per restituire istanze dell'acceptor e dell'iniziatore definiti ai passaggi 2 e 1.
Creare una classe che implementi StreamUpgradeBindingElement.
Eseguire l'override del metodo BuildClientStreamUpgradeProvider sul client e del metodo BuildServerStreamUpgradeProvider sul servizio.
Eseguire l'override del metodo BuildChannelFactory sul client e il metodo BuildChannelListener sul servizio, per aggiungere l'elemento di associazione di aggiornamento a BindingParameters.
Aggiungere il nuovo elemento di associazione di aggiornamento flusso alle associazioni sui computer server e client.
Aggiornamenti della protezione
L'aggiunta di un aggiornamento della protezione è una versione specifica del processo generale di aggiornamento flusso.
WCF fornisce già due elementi di binding per l'aggiornamento della protezione del flusso. La configurazione della protezione a livello di trasporto viene incapsulata dalle classi WindowsStreamSecurityBindingElement e SslStreamSecurityBindingElement, che possono essere configurate e aggiunte a un'associazione personalizzata. Questi elementi di associazione estendono la classe StreamUpgradeBindingElement che crea i provider di aggiornamento flusso client e server. Questi elementi di associazione includono metodi che creano le classi di provider di aggiornamento flusso di sicurezza specifiche, che non sono public, pertanto, per questi due casi, tutto ciò che è necessario fare è aggiungere l'elemento di associazione all'associazione.
Per gli scenari di sicurezza non soddisfatti dai due elementi di associazione precedenti vengono derivate tre classi abstract correlate alla protezione dalle classi di base di iniziatore, acceptor e provider precedenti:
Il processo di implementazione di un aggiornamento flusso di sicurezza è identico al precedente, con la sola differenza della derivazione da queste tre classi. Eseguire l'override delle proprietà aggiuntive in queste classi, per fornire informazioni sulla protezione al runtime.
Aggiornamenti multipli
Per creare ulteriori richieste di aggiornamento ripetere il processo precedente: creare estensioni aggiuntive di StreamUpgradeProvider ed elementi di associazione. Aggiungere gli elementi di associazione all'associazione. Gli elementi di associazione aggiuntivi vengono elaborati in sequenza, a partire dal primo elemento di associazione aggiunto all'associazione. In BuildChannelFactory e BuildChannelListener, ogni provider di aggiornamento può determinare a quale livello collocarsi su qualsiasi parametro di associazione di aggiornamento preesistente. Deve quindi sostituire il parametro di associazione di aggiornamento esistente con un nuovo parametro di associazione di aggiornamento composito.
In alternativa, un provider di aggiornamento può supportare più aggiornamenti. Può, ad esempio, essere necessario implementare un provider di aggiornamento flusso personalizzato che supporti sia la protezione che la compressione. Effettua i passaggi seguenti:
Sottoclassare StreamSecurityUpgradeProvider per scrivere la classe di provider che crea l'iniziatore e l'acceptor.
Sottoclassare StreamSecurityUpgradeInitiator assicurandosi di eseguire l'override del metodo GetNextUpgrade per restituire i tipi di contenuto per il flusso di compressione e il flusso di sicurezza, in ordine.
Sottoclassare StreamSecurityUpgradeAcceptor che comprende i tipi di contenuto personalizzati nel relativo metodo CanUpgrade.
Il flusso verrà aggiornato dopo ogni chiamata a GetNextUpgrade e CanUpgrade.