Modifica dei livelli di condivisione della cache per le attività Send

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

L'estensione SendMessageChannelCache consente di personalizzare i livelli di condivisione della cache, le impostazioni della cache della channel factory e della cache del canale per i flussi di lavoro che inviano messaggi agli endpoint del servizio tramite le attività di messaggistica Send. Si tratta in genere di flussi di lavoro client, ma potrebbero essere anche servizi di flusso di lavoro ospitati in un oggetto WorkflowServiceHost. La cache della channel factory contiene gli oggetti ChannelFactory memorizzati nella cache. La cache del canale contiene i canali memorizzati nella cache.

Nota:
I flussi di lavoro possono utilizzare le attività di messaggistica Send per inviare messaggi o parametri. L'esecuzione del flusso di lavoro aggiunge channel factory alla cache che creano canali di tipo IRequestChannel quando si utilizza un'attività ReceiveReply con un'attività Send e un oggetto IOutputChannel quando si utilizza solo un'attività Send (nessuna attività ReceiveReply).

Livelli di condivisione della cache

Per impostazione predefinita, in un flusso di lavoro ospitato da un oggetto WorkflowServiceHost, la cache utilizzata dalle attività di messaggistica Send è condivisa da tutte le istanze del flusso di lavoro nell'oggetto WorkflowServiceHost (memorizzazione nella cache a livello di host). Per un flusso di lavoro del client che non è ospitato da un oggetto WorkflowServiceHost, la cache è disponibile solo all'istanza del flusso di lavoro (memorizzazione nella cache a livello di istanza). La cache è disponibile solo per le attività Send che non utilizzano gli endpoint definiti nella configurazione, a meno che non sia abilitata la memorizzazione nella cache non sicura.

Di seguito sono riportati i diversi livelli di condivisione della cache disponibili per le attività Send in un flusso di lavoro e il relativo utilizzo consigliato:

• Livello host: nel livello di condivisione host la cache è disponibile solo per le istanze del flusso di lavoro ospitate nell'host del servizio flusso di lavoro. Una cache può essere condivisa anche tra host del servizio flusso di lavoro di una cache a livello di processo.

• Livello istanza: nel livello di condivisione istanza la cache è disponibile per una particolare istanza del flusso di lavoro per tutta la relativa durata, ma non per le altre istanze del flusso di lavoro.

• Nessuna cache: la cache viene disattivata per impostazione predefinita qualora un flusso di lavoro utilizzi gli endpoint definiti nella configurazione. In questo caso, è consigliabile mantenere disattivata la cache anche perché l'attivazione potrebbe risultare non sicura, ad esempio, se per ogni invio è necessaria un'identità diversa (credenziali diverse o utilizzo della rappresentazione).

Modifica del livello di condivisione della cache per un flusso di lavoro client

Per impostare la condivisione della cache in un flusso di lavoro client, aggiungere un'istanza della classe SendMessageChannelCache come estensione al set desiderato di istanze del flusso di lavoro. In questo modo la cache viene condivisa in tutte le istanze del flusso di lavoro. Negli esempi di codice seguenti viene mostrato come eseguire questi passaggi.

Innanzitutto, dichiarare un'istanza di tipo SendMessageChannelCache.

    // Create an instance of SendMessageChannelCache with default cache settings.
    static SendMessageChannelCache sharedChannelCacheExtension =
        new SendMessageChannelCache();

Successivamente, aggiungere l'estensione della cache a ogni istanza del flusso di lavoro client.

    WorkflowApplication clientInstance1 = new WorkflowApplication(new clientWorkflow1());
    WorkflowApplication clientInstance2 = new WorkflowApplication(new clientWorkflow2());

    // Share the cache extension object 

    clientInstance1.Extensions.Add(sharedChannelCacheExtension);
    clientInstance2.Extensions.Add(sharedChannelCacheExtension);

Modifica del livello di condivisione della cache per un servizio di flusso di lavoro ospitato

Per impostare la condivisione della cache in un servizio di flusso di lavoro ospitato, aggiungere un'istanza della classe SendMessageChannelCache come estensione a tutti gli host del servizio di flusso di lavoro. In questo modo la cache viene condivisa in tutti gli host del servizio di flusso di lavoro. Negli esempi di codice seguenti viene mostrato come eseguire questi passaggi.

Innanzitutto, dichiarare un'istanza di tipo SendMessageChannelCache a livello di classe.

    // Create static instance of SendMessageChannelCache with default cache settings.
    static SendMessageChannelCache sharedChannelCacheExtension = new
        SendMessageChannelCache();

Successivamente, aggiungere l'estensione della cache statica a ogni host del servizio di flusso di lavoro.

    WorkflowServiceHost host1 = new WorkflowServiceHost(new serviceWorkflow1(), new Uri(baseAddress1));
    WorkflowServiceHost host2 = new WorkflowServiceHost(new serviceWorkflow2(), new Uri(baseAddress2));

    // Share the static cache to get an AppDomain level cache.
    host1.WorkflowExtensions.Add(sharedChannelCacheExtension);
    host2.WorkflowExtensions.Add(sharedChannelCacheExtension);

Per impostare la divisione della cache in un servizio flusso di lavoro ospitato a livello di istanza, aggiungere un delegato Func<SendMessageChannelCache> come estensione all'host del servizio flusso di lavoro e assegnare questo delegato al codice che crea una nuova istanza della classe SendMessageChannelCache. Ciò comporta una cache diversa per ogni singola istanza del flusso di lavoro, anziché una sola cache condivisa da tutte le istanze del flusso di lavoro nell'host del servizio flusso di lavoro. Nell'esempio di codice seguente viene mostrato come eseguire questa operazione tramite un'espressione lambda per definire direttamente l'estensione SendMessageChannelCache a cui il delegato fa riferimento.

    serviceHost.WorkflowExtensions.Add(() => new SendMessageChannelCache
    {
        // Use FactorySettings property to add custom factory cache settings.
        FactorySettings = new ChannelCacheSettings 
        { MaxItemsInCache = 5, },
        // Use ChannelSettings property to add custom channel cache settings.
        ChannelSettings = new ChannelCacheSettings 
        { MaxItemsInCache = 10 },
    });

Personalizzazione delle impostazioni della cache

È possibile personalizzare le impostazioni della cache della channel factory e del canale. Le impostazioni della cache sono definite nella classe ChannelCacheSettings. La classe SendMessageChannelCache definisce le impostazioni predefinite per la cache della channel factory e del canale nel costruttore predefinito. Nella tabella seguente vengono elencati i valori predefiniti di queste impostazioni per ogni tipo di cache.

Impostazioni	LeaseTimeout (min)	IdleTimeout (min)	MaxItemsInCache
Valore predefinito della cache della factory	TimeSpan.MaxValue	2	16
Valore predefinito della cache del canale	5	2	16

Per personalizzare le impostazioni della cache della factory e del canale, creare un'istanza della classe SendMessageChannelCache utilizzando il costruttore con parametri SendMessageChannelCache e passare una nuova istanza dell'oggetto ChannelCacheSettings con valori personalizzati a ognuno dei parametri factorySettings e channelSettings. Successivamente aggiungere la nuova istanza di questa classe come estensione a un host del servizio di flusso di lavoro o a un'istanza del flusso di lavoro. Nell'esempio di codice seguente viene mostrato come eseguire questi passaggi per un'istanza del flusso di lavoro.

    ChannelCacheSettings factorySettings = new ChannelCacheSettings{
                            MaxItemsInCache = 5, 
                            IdleTimeout = TimeSpan.FromMinutes(5), 
                            LeaseTimeout = TimeSpan.FromMinutes(20)};

    ChannelCacheSettings channelSettings = new ChannelCacheSettings{
                            MaxItemsInCache = 5, 
                            IdleTimeout = TimeSpan.FromMinutes(2),
                            LeaseTimeout = TimeSpan.FromMinutes(10) };
    
    SendMessageChannelCache customChannelCacheExtension = 
        new SendMessageChannelCache(factorySettings, channelSettings);
     
    clientInstance.Extensions.Add(customChannelCacheExtension);

Per abilitare la memorizzazione nella cache quando il servizio di flusso di lavoro dispone di endpoint definiti nella configurazione, creare un'istanza della classe SendMessageChannelCache utilizzando il costruttore con parametri SendMessageChannelCache con il parametro allowUnsafeCaching impostato su true. Successivamente aggiungere la nuova istanza di questa classe come estensione a un host del servizio di flusso di lavoro o a un'istanza del flusso di lavoro. Nell'esempio di codice seguente viene mostrato come abilitare la memorizzazione nella cache per un'istanza del flusso di lavoro.

    SendMessageChannelCache customChannelCacheExtension = 
        new SendMessageChannelCache{ AllowUnsafeCaching = true };

    clientInstance.Extensions.Add(customChannelCacheExtension);

Per disabilitare completamente la cache per le channel factory e i canali, disabilitare la cache della channel factory. In questo modo viene disattivata anche la cache del canale poiché i canali appartengono alle channel factory corrispondenti. Per disabilitare la cache della channel factory, passare il parametro factorySettings al costruttore SendMessageChannelCache inizializzato su un'istanza ChannelCacheSettings con un valore MaxItemsInCache pari a 0. Nell'esempio di codice seguente viene illustrata questa operazione.

    // Disable the factory cache. This results in the channel cache to be turned off as well.
    ChannelCacheSettings factorySettings = new ChannelCacheSettings
        { MaxItemsInCache = 0 };

    ChannelCacheSettings channelSettings = new ChannelCacheSettings();

    SendMessageChannelCache customChannelCacheExtension = 
        new SendMessageChannelCache(factorySettings, channelSettings); 

    clientInstance.Extensions.Add(customChannelCacheExtension);

È possibile scegliere di utilizzare solo la cache della channel factory e disabilitare la cache del canale passando il parametro channelSettings al costruttore SendMessageChannelCache inizializzato su un'istanza ChannelCacheSettings con un valore MaxItemsInCache pari a 0. Nell'esempio di codice seguente viene illustrata questa operazione.

    ChannelCacheSettings factorySettings = new ChannelCacheSettings();
    // Disable only the channel cache.
    ChannelCacheSettings channelSettings = new ChannelCacheSettings
        { MaxItemsInCache = 0};

    SendMessageChannelCache customChannelCacheExtension = 
        new SendMessageChannelCache(factorySettings, channelSettings); 

    clientInstance.Extensions.Add(customChannelCacheExtension);

In un servizio di flusso di lavoro ospitato è possibile specificare le impostazioni della cache della factory e della cache del canale nel file di configurazione dell'applicazione. A tale scopo, aggiungere un comportamento del servizio contenente le impostazioni della cache della factory e del canale e aggiungere tale comportamento al servizio. Nell'esempio seguente viene mostrato il contenuto di un file di configurazione che include il comportamento del servizio MyChannelCacheBehavior con le impostazioni personalizzate della cache della factory e del canale. Tale comportamento viene aggiunto al servizio tramite l'attributo behaviorConfiguarion.

<configuration>  
  <system.serviceModel>
    <!-- List of other config sections here --> 
    <behaviors>
      <serviceBehaviors>
        <behavior name="MyChannelCacheBehavior">
          <sendMessageChannelCache allowUnsafeCaching ="false" >
            <!-- Control only the host level settings --> 
            <factorySettings maxItemsInCache = "8" idleTimeout = "00:05:00" leaseTimeout="10:00:00" />
            <channelSettings maxItemsInCache = "32" idleTimeout = "00:05:00" leaseTimeout="00:06:00" />
          </sendMessageChannelCache>
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <services>
      <service name="MyService" behaviorConfiguration="MyChannelCacheBehavior" />
    </services>
  </system.serviceModel>
</configuration>