Abilitare la cache locale di Windows Server AppFabric (XML)

Windows Server AppFabric offre la possibilità di configurare un client della cache a livello di programmazione o mediante un file di configurazione dell'applicazione. In questo argomento vengono descritte le procedure per abilitare la cache locale sul relativo client quando si utilizza un file di configurazione dell'applicazione basato su XML. Per informazioni sull'esecuzione di questa operazione tramite programmazione, vedere Abilitare la cache locale di Windows Server AppFabric.

Nel file di configurazione dell'applicazione, le impostazioni della cache locale sono definite nell'elemento figlio localCache dell'elemento dataCacheClient. L'attributo isEnabled nell'elemento localCache consente di stabilire se la cache locale è abilitata o meno. In alternativa, è possibile che l'elemento localCache sia mancante o impostato come commento per indicare che è disabilitato. Per ulteriori informazioni sulle impostazioni di configurazione dell'applicazione, vedere Impostazioni di configurazione dell'applicazione (Memorizzazione nella cache di Windows Server AppFabric).

Tali procedure presuppongono la preventiva preparazione dell'ambiente di sviluppo e l'impostazione dei riferimenti negli assembly di memorizzazione nella cache di AppFabric e così via. Per ulteriori informazioni, vedere Preparazione dell'ambiente di sviluppo del client cache (Memorizzazione nella cache di Windows Server AppFabric).

Per abilitare la cache locale con un file di configurazione dell'applicazione

  1. Creare il file di configurazione dell'applicazione denominato App.config e aggiungerlo al progetto. Per ulteriori informazioni, vedere Introduzione a un client cache Windows Server AppFabric (XML).

  2. Aggiungere localCache come elemento figlio dell'elemento dataCacheClient.

  3. Per abilitare la cache locale, impostare l'attributo isEnabled dell'elemento localCache su true.

  4. Impostare l'attributo sync nell'elemento localCache. Impostare l'attributo su TimeoutBased per utilizzare un periodo di timeout per invalidare la cache locale. Utilizzare l'elemento NotificationBased per utilizzare notifiche cache aggiuntive per invalidare la cache locale. Per utilizzare l'opzione NotificationsBased è necessario abilitare le notifiche cache nella cache denominata. Per ulteriori informazioni, vedere Notifiche cache (Memorizzazione nella cache di Windows Server AppFabric).

  5. Impostare l'attributo ttlValue nell'elemento localCache su un valore pari al numero desiderato di secondi in cui gli oggetti dovranno rimanere nella cache locale. Il valore predefinito è 300 secondi. Per ulteriori informazioni, vedere Scadenza e rimozione (Memorizzazione nella cache di Windows Server AppFabric)

  6. Facoltativamente, impostare l'attributo objectCount nell'elemento localCache per specificare il numero massimo di oggetti memorizzati nella cache locale. Il valore predefinito è 10.000 oggetti. Tale soglia indica al client della cache di iniziare a rimuovere il 20% degli oggetti memorizzati nella cache utilizzati meno di recente.

  7. Facoltativamente, se si utilizzano le notifiche cache e si desidera specificare un intervallo di polling diverso dal valore predefinito di 300 secondi, aggiungere clientNotification come elemento figlio dell'elemento dataCacheClient. Utilizzare l'attributo pollInterval dell'elemento clientNotification per specificare il valore dell'intervallo di polling. È possibile utilizzare questo elemento e questo attributo per specificare un intervallo di polling per le notifiche cache anche se non si desidera utilizzare la cache locale.

Esempio

In questo esempio viene mostrato l'aspetto dell'elemento della cache locale quando quest'ultima è abilitata. Questo elemento deve essere aggiunto all'interno dell'elemento dataCacheClient.

XML

<!-- local cache enabled -->
<localCache
  isEnabled="true"
  sync="TimeoutBased"
  objectCount="100000"
  ttlValue="300" />

In questo file di configurazione dell'applicazione di esempio la cache locale è abilitata ed è configurata per puntare al server cache CacheServer1. Per utilizzare l'esempio, sostituire il nome del server indicato con il nome del server cache. Aggiungere o rimuovere i tag host secondo necessità in base all'ambiente.

Idealmente, specificare gli host cache designati come host principali. In genere, gli host principali sono i primi server di cache installati nel cluster. Per ulteriori informazioni sugli host principali, vedere Diagramma dell'architettura fisica della memorizzazione nella cache di Windows Server AppFabric. Per determinare quali host siano principali, utilizzare lo strumento di amministrazione di Windows PowerShell. Per ulteriori informazioni su Windows PowerShell, vedere Utilizzo di Windows PowerShell per la gestione delle funzionalità di Memorizzazione nella cache di Windows Server AppFabric.

noteNota
È possibile che inizialmente vengano aggiunti automaticamente elementi al file di configurazione dell'applicazione. Questi elementi aggiuntivi non sono richiesti dalla funzionalità di memorizzazione nella cache di AppFabric e possono essere eliminati se non altrimenti richiesti per l'applicazione.

XML

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
   <!--configSections must be the FIRST element -->
   <configSections>
      <!-- required to read the <dataCacheClient> element -->
      <section name="dataCacheClient"
         type="Microsoft.ApplicationServer.Caching.DataCacheClientSection,
            Microsoft.ApplicationServer.Caching.Core, Version=1.0.0.0, 
            Culture=neutral, PublicKeyToken=31bf3856ad364e35"
         allowLocation="true"
         allowDefinition="Everywhere"/>
   </configSections>

   <dataCacheClient>
      <!-- (optional) specify local cache -->
      <localCache
         isEnabled="true"
         sync="TimeoutBased"
         objectCount="100000"
         ttlValue="300" />

      <!--(optional) specify cache notifications poll interval
      <clientNotification pollInterval="300" /> -->

      <hosts>
         <host
            name="CacheServer1"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

Vedere anche

  2011-12-05
Mostra: