Utilizzo di sessioni

Nelle applicazioni Windows Communication Foundation (WCF), una sessione correla un gruppo di messaggi in una conversazione. Le sessioni WCF sono differenti dall'oggetto sessione disponibile nelle applicazioni ASP.NET, supportano comportamenti diversi e sono controllate in modi diversi. In questo argomento vengono descritte le funzionalità che vengono attivate dalle sessioni nelle applicazioni WCF e le relative modalità di utilizzo.

Sessioni nelle applicazioni Windows Communication Foundation

Quando un contratto di servizio specifica che è necessaria una sessione, significa che tutte le chiamate, ovvero gli scambi di messaggi sottostanti che supportano le chiamate, devono essere parte della stessa conversazione. Se un contratto consente sessioni ma non ne richiede, i client possono connettersi e possono stabilire o meno una sessione. Se, al termine della sessione, un messaggio viene inviato sullo stesso canale basato sulla sessione, viene generata un'eccezione.

Le principali caratteristiche delle sessioni WCF sono le seguenti:

• Vengono avviate e terminate esplicitamente dall'applicazione chiamante (client WCF).

• I messaggi recapitati durante una sessione vengono elaborati nell'ordine in cui vengono ricevuti.

• Le sessioni consentono di correlare un gruppo di messaggi in una conversazione. Sono possibili diversi tipi di correlazione. Un canale basato sulla sessione, ad esempio, è in grado di correlare messaggi basati su una connessione di rete condivisa mentre un altro canale basato sulla sessione è in grado di correlare messaggi basati su un tag condiviso nel corpo del messaggio. Le funzionalità che possono derivare dalla sessione dipendono dalla natura della correlazione.

• Non esiste alcun archivio dati generale associato a una sessione WCF.

Se si ha familiarità con la classe System.Web.SessionState.HttpSessionState in applicazioni ASP.NET e con la funzionalità fornita, è possibile notare le differenze seguenti tra quel tipo di sessioni e le sessioni WCF:

• Le sessioni ASP.NET sono sempre avviate dal server.

• Le sessioni ASP.NET sono implicitamente non ordinate.

• Le sessioni ASP.NET forniscono un meccanismo di archiviazione dati generale tramite richieste.

In questo argomento vengono descritti gli argomenti seguenti:

• Il comportamento di esecuzione predefinito quando si utilizzano associazioni basate su sessione nel livello del modello di servizio.

• I tipi di funzionalità forniti dalle associazioni fornite dal sistema, basate sulla sessione WCF.

• Come creare un contratto che dichiara un requisito della sessione.

• Come comprendere e controllare la creazione e chiusura della sessione e la relazione della sessione all'istanza del servizio.

Comportamento di esecuzione predefinito utilizzando le sessioni

Un'associazione che tenta di avviare una sessione è chiamata un'associazione basata sulla sessione. Nei contratti di servizio viene specificata la richiesta, permesso o rifiuto di associazioni basate sulla sessione tramite l'impostazione della proprietà System.ServiceModel.ServiceContractAttribute.SessionMode sull'interfaccia del contratto di servizio (o classe) su uno dei valori di enumerazione System.ServiceModel.SessionMode. Per impostazione predefinita, il valore di questa proprietà è Allowed, che significa che se un client utilizza un'associazione basata sulla sessione con un'implementazione di servizio WCF, il servizio stabilisce e utilizza la sessione fornita.

Quando un servizio WCF accetta una sessione client, per impostazione predefinita vengono attivate le funzionalità seguenti:

1. Tutte le chiamate tra un oggetto client WCF sono gestite dalla stessa istanza del servizio.

2. Diverse associazioni basate sulla sessione forniscono caratteristiche aggiuntive.

Tipi di sessione forniti dal sistema

Un'associazione basata sulla sessione supporta l'associazione predefinita di un'istanza del servizio con una determinata sessione. Tuttavia, associazioni basate sulla sessione diverse supportano funzionalità diverse oltre a consentire il controllo delle istanze basate sulla sessione descritto in precedenza.

In WCF vengono forniti i tipi seguenti di comportamento dell'applicazione basato sulla sessione:

• System.ServiceModel.Channels.SecurityBindingElement supporta sessioni basate sulla protezione nelle quali entrambe le parti della comunicazione hanno concordato una conversazione sicura specifica. Per ulteriori informazioni, vedere Protezione dei servizi. Ad esempio, l'associazione System.ServiceModel.WSHttpBinding, che contiene il supporto sia per le sessioni di sicurezza sia per le sessioni affidabili, per impostazione predefinita utilizza solo una sessione protetta che esegue la crittografia e la firma digitale dei messaggi.

• L'associazione System.ServiceModel.NetTcpBinding supporta le sessioni TCP/IP per garantire che tutti i messaggi siano correlati in base alla connessione a livello di socket.

• L'elemento System.ServiceModel.Channels.ReliableSessionBindingElement, che implementa la specifica WS-ReliableMessaging, supporta le sessioni affidabili in cui i messaggi possono essere configurati per essere recapitati nell'ordine ed esattamente una volta, in modo da garantire che i messaggi siano ricevuti anche quando durante la conversazione i messaggi passano per più nodi. Per ulteriori informazioni, vedere Sessioni affidabili.

• L'associazione System.ServiceModel.NetMsmqBinding fornisce sessioni di datagramma di MSMQ. Per ulteriori informazioni, vedere Code in Windows Communication Foundation.

L'impostazione della proprietà SessionMode non specifica il tipo di sessione richiesto dal contratto ma soltanto che il contratto ne richiede una.

Creazione di un contratto che richiede una sessione.

La creazione di un contratto che richiede una sessione dichiara che il gruppo di operazioni che vengono dichiarate dal contratto di servizio devono essere eseguite tutte all'interno della stessa sessione e che i messaggi devono essere recapitati nell'ordine. Per asserire il livello di supporto della sessione richiesto da un contratto di servizio, impostare la proprietà System.ServiceModel.ServiceContractAttribute.SessionMode sull'interfaccia o classe del contratto di servizio sul valore dell'enumerazione System.ServiceModel.SessionMode da specificare se il contratto:

• Richiede una sessione.

• Consente a un client di stabilire una sessione.

• Proibisce una sessione.

L'impostazione della proprietà SessionMode non specifica, tuttavia, il tipo di comportamento basato sulla sessione richiesto dal contratto. Indica a WCF di confermare in fase di esecuzione che l'associazione configurata, la quale crea il canale di comunicazione, per il servizio è più o meno in grado di stabilire una sessione quando viene implementato un servizio. Nuovamente, l'associazione è in grado di soddisfare tale requisito con qualsiasi tipo di comportamento basato sulla sessione che sceglie: protezione, trasporto, affidabile o una combinazione di questi. Il comportamento esatto dipende dal valore System.ServiceModel.SessionMode selezionato. Se l'associazione configurata del servizio non è conforme al valore di SessionMode, viene generata un'eccezione. Si dice che associazioni e i canali che creano quelle sessioni del supporto siano basato sulla sessione.

Il contratto di servizio seguente specifica che tutte le operazioni in ICalculatorSession devono essere scambiate all'interno di una sessione. Nessuna delle operazioni restituisce un valore al chiamante eccetto il metodo Equals. Tuttavia, il metodo Equals non prende parametri e, pertanto, può restituire solo un valore diverso da zero all'interno di una sessione nella quale i dati sono già stati passati alle altre operazioni. Per un funzionamento corretto, questo contratto necessita di una sessione. Senza una sessione associata a un client specifico, l'istanza del servizio non ha modo di conoscere i dati precedenti inviati da questo client.

<ServiceContract(Namespace:="http://Microsoft.ServiceModel.Samples", SessionMode:=SessionMode.Required)> _
Public Interface ICalculatorSession

    <OperationContract(IsOneWay:=True)> _
    Sub Clear()
    <OperationContract(IsOneWay:=True)> _
    Sub AddTo(ByVal n As Double)
    <OperationContract(IsOneWay:=True)> _
    Sub SubtractFrom(ByVal n As Double)
    <OperationContract(IsOneWay:=True)> _
    Sub MultiplyBy(ByVal n As Double)
    <OperationContract(IsOneWay:=True)> _
    Sub DivideBy(ByVal n As Double)
    <OperationContract()> _
    Function Equal() As Double
End Interface

[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples", SessionMode=SessionMode.Required)]
public interface ICalculatorSession
{
    [OperationContract(IsOneWay=true)]
    void Clear();
    [OperationContract(IsOneWay = true)]
    void AddTo(double n);
    [OperationContract(IsOneWay = true)]
    void SubtractFrom(double n);
    [OperationContract(IsOneWay = true)]
    void MultiplyBy(double n);
    [OperationContract(IsOneWay = true)]
    void DivideBy(double n);
    [OperationContract]
    double Equals();
}

Se un servizio autorizza a una sessione, allora ne viene stabilita e utilizzata se il client ne avvia una; in caso contrario, non viene stabilita alcuna sessione.

Sessioni e istanze del servizio

Se si utilizza il comportamento di istanza predefinito in WCF, tutte le chiamate tra un oggetto client di WCF vengono gestite dalla stessa istanza del servizio. Di conseguenza, a livello di applicazione, è possibile pensare a una sessione come attivazione di un comportamento dell'applicazione simile al comportamento della chiamata locale. Ad esempio, quando si crea un oggetto locale:

• Viene chiamato un costruttore.

• Tutte le chiamate successive eseguite al riferimento dell'oggetto client di WCF sono elaborate dalla stessa istanza dell'oggetto.

• Viene chiamato un distruttore quando il riferimento dell'oggetto viene distrutto.

Le sessioni attivano un comportamento simile tra client e servizi finché viene utilizzato il comportamento di istanza di servizio predefinito. Se un contratto di servizio richiede o supporta le sessioni, è possibile contrassegnare una o più operazioni del contratto come di avvio o chiusura di una sessione impostando le proprietà IsInitiating e IsTerminating.

Operazioni di avvio sono quelle che devono essere chiamate come prima operazione di una nuova sessione. Le operazioni non di avvio possono essere chiamate solo dopo che è stata chiamata almeno un'operazione di avvio. È pertanto possibile creare qualche tipo di costruttore di sessione per il servizio dichiarando operazioni di avvio progettate per ricevere dai client input appropriato per l'inizio dell'istanza del servizio. Tuttavia, lo stato è associato alla sessione e non all'oggetto servizio.

Operazioni di chiusura, al contrario, sono quelle che devono essere chiamate come ultimo messaggio in una sessione esistente. Nel caso predefinito, WCF ricicla l'oggetto servizio e il relativo contesto dopo la chiusura della sessione con cui è associato il servizio. È possibile, pertanto, creare un tipo di distruttore dichiarando operazioni di chiusura progettate per eseguire una funzione appropriata alla fine dell'istanza del servizio.

Nota:

Anche se il comportamento predefinito reca qualche somiglianza con costruttori e distruttori locali, si tratta solo di una somiglianza. Qualsiasi operazione di servizio WCF può essere un'operazione di avvio o chiusura, o entrambe allo stesso tempo. Inoltre, nel caso predefinito, le operazioni di avvio possono essere chiamate qualsiasi numero di volte e in qualsiasi ordine; dopo che la sessione è stata stabilita e associata a un'istanza non vengono create altre sessioni a meno che non venga controllata in modo esplicito la durata dell'istanza del servizio (modificando l'oggetto System.ServiceModel.InstanceContext). Infine, lo stato viene associato alla sessione e non all'oggetto servizio.

Ad esempio, il contratto ICalculatorSession utilizzato nell'esempio precedente richiede che l'oggetto client WCF chiami innanzitutto l'operazione Clear prima di qualsiasi altra e che la sessione con questo oggetto client WCF debba terminare quando viene chiamata l'operazione Equals. Nell'esempio di codice seguente è illustrato un contratto che applica questi requisiti. Clear deve essere chiamato per primo per avviare una sessione e tale sessione termina quando viene chiamato Equals.

<ServiceContract(Namespace:="http://Microsoft.ServiceModel.Samples", SessionMode:=SessionMode.Required)> _
Public Interface ICalculatorSession

    <OperationContract(IsOneWay:=True, IsInitiating:=True, IsTerminating:=False)> _
    Sub Clear()
    <OperationContract(IsOneWay:=True, IsInitiating:=False, IsTerminating:=False)> _
    Sub AddTo(ByVal n As Double)
    <OperationContract(IsOneWay:=True, IsInitiating:=False, IsTerminating:=False)> _
    Sub SubtractFrom(ByVal n As Double)
    <OperationContract(IsOneWay:=True, IsInitiating:=False, IsTerminating:=False)> _
    Sub MultiplyBy(ByVal n As Double)
    <OperationContract(IsOneWay:=True, IsInitiating:=False, IsTerminating:=False)> _
    Sub DivideBy(ByVal n As Double)
    <OperationContract(IsInitiating:=False, IsTerminating:=True)> _
    Function Equal() As Double
End Interface

[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples", SessionMode=SessionMode.Required)]
public interface ICalculatorSession
{
    [OperationContract(IsOneWay=true, IsInitiating=true, IsTerminating=false)]
    void Clear();
    [OperationContract(IsOneWay = true, IsInitiating = false, IsTerminating = false)]
    void AddTo(double n);
    [OperationContract(IsOneWay = true, IsInitiating = false, IsTerminating = false)]
    void SubtractFrom(double n);
    [OperationContract(IsOneWay = true, IsInitiating = false, IsTerminating = false)]
    void MultiplyBy(double n);
    [OperationContract(IsOneWay = true, IsInitiating = false, IsTerminating = false)]
    void DivideBy(double n);
    [OperationContract(IsInitiating = false, IsTerminating = true)]
    double Equals();
}

I servizi non avviano sessioni con i client. Nelle applicazioni client WCF, esiste una relazione diretta tra la durata del canale basato sulla sessione e la durata della sessione stessa. In tal senso, i client creano nuove sessioni creando nuovi canali basati sulla sessione e chiudono le sessioni esistenti chiudendo normalmente i canali basati sulla sessione. Un client avvia una sessione con un endpoint del servizio chiamando uno degli elementi seguenti:

• System.ServiceModel.ICommunicationObject.Open nel canale restituito da una chiamata a System.ServiceModel.ChannelFactory.CreateChannel.

• System.ServiceModel.ClientBase.Open nell'oggetto client WCF generato da Strumento ServiceModel Metadata Utility Tool (Svcutil.exe).

• Un'operazione di avvio su un tipo di oggetto client WCF (per impostazione predefinita, tutte le operazioni sono di avvio). Quando la prima operazione viene chiamata, l'oggetto client WCF apre automaticamente il canale e avvia una sessione.

In genere, un client termina una sessione con un endpoint del servizio chiamando uno degli elementi seguenti:

• System.ServiceModel.ICommunicationObject.Close nel canale restituito da una chiamata a System.ServiceModel.ChannelFactory.CreateChannel.

• System.ServiceModel.ClientBase.Close nell'oggetto client WCF generato da Svcutil.exe.

• Un'operazione di chiusura su un tipo di oggetto client WCF (per impostazione predefinita, nessuna operazione è di chiusura; il contratto deve specificare in modo esplicito un'operazione di chiusura). Quando la prima operazione viene chiamata, l'oggetto client WCF apre automaticamente il canale e avvia una sessione.

Per esempi, vedere Procedura: creare un servizio che richiede sessioni e gli esempi Comportamento predefinito del servizio e Istanze.

Per ulteriori informazioni su sui client e le sessioni, vedere Accesso ai servizi tramite client.

Sessioni che interagiscono con impostazioni InstanceContext

Esiste un'interazione tra l'enumerazione SessionMode in un contratto e la proprietà System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode, che consente di controllare l'associazione tra canali e oggetti servizio specifici. Per ulteriori informazioni, vedere Sessioni, istanze e concorrenza.

Condivisione di oggetti InstanceContext

È inoltre possibile controllare l'associazione tra canali basati sulla sessione o chiamate con sessione e oggetti InstanceContext eseguendo quell'associazione. Per un esempio completo, vedere InstanceContextSharing.

Sessioni e flusso

Quando è necessario trasferire una notevole quantità di dati, la modalità di trasferimento in flusso di WCF è un'alternativa possibile al comportamento predefinito di memorizzazione nel buffer ed elaborazione in memoria dei messaggi per intero. È possibile ricevere un comportamento imprevisto quando viene eseguito il flusso delle chiamate con un'associazione basata sulla sessione. Tutte le chiamate del flusso sono eseguite tramite un solo canale (il canale del datagramma) che non supporta sessioni anche se l'associazione utilizzata è configurata per utilizzare sessioni. Se più client effettuano un flusso di chiamate allo stesso oggetto servizio con un'associazione basata sulla sessione, la modalità di concorrenza dell'oggetto servizio è impostata su Single e la modalità di contesto dell'istanza è impostata su PerSession, tutte le chiamate devono transitare attraverso il canale del datagramma, pertanto viene elaborata una sola chiamata alla volta. Uno o più client possono quindi scadere. È possibile risolvere questo problema impostando InstanceContextMode dell'oggetto servizio su PerCall o Concurrency su Multiple.

Nota:
In questo caso, MaxConcurrentSessions non produce alcun effetto perché è disponibile una sola "sessione".

Vedere anche

Riferimento

IsInitiating
IsTerminating