Habilitar cache local (XML) do Windows Server AppFabric

O Windows Server AppFabric oferece a opção para configurar um cliente de cache de forma programática ou com um arquivo de configuração de aplicativo. Os procedimentos neste tópico descrevem como habilitar o cache local em seu cliente de cache quando você usa um arquivo de configuração de aplicativo baseado em XML. Para obter informações sobre como fazer isso de forma programática, consulte Habilitar cache local do Windows Server AppFabric.

No arquivo de configuração de aplicativo, as configurações de cache local são definidas no elemento localCache, um filho do elemento dataCacheClient. O atributo isEnabled no elemento localCache determina se o cache local está habilitado ou não. Como alternativa, o elemento localCache pode estar faltando (ou ser marcado como ignorado) para indicar que está desabilitado. Para obter mais informações sobre as definições de configuração de aplicativo, consulte Definições de configuração do aplicativo (Cache do Windows Server AppFabric).

Estes procedimentos supõem que você já tenha preparado o seu ambiente de desenvolvimento e definido as referências para os conjuntos de cache do AppFabric, e assim por diante. Para obter mais informações, consulte Preparando o ambiente de desenvolvimento do cliente de cache (Cache do Windows Server AppFabric).

Para habilitar o cache local com um arquivo de configuração de aplicativo

1. Crie o arquivo de configuração de aplicativo, denominado App.config, e adicione-o ao seu projeto. Para obter mais informações, consulte Introdução a um cliente de cache (XML) do Windows Server AppFabric.

2. Adicione o elemento localCache como um filho do elemento dataCacheClient.

3. Defina o atributo isEnabled do elemento localCache igual a true para habilitar o cache local.

4. Defina o atributo sync no elemento localCache. Defina esse atributo como TimeoutBased, a fim de usar um tempo limite para invalidar o cache local. Use NotificationBased para usar também notificações de cache para invalidar o cache local. A opção NotificationsBased exige que você habilite as notificações de cache no cache nomeado. Para obter mais informações, consulte Notificações de cache (cache do Windows Server AppFabric).

5. Defina o atributo ttlValue no elemento localCache igual ao número desejado de segundos que os objetos devem permanecer no cache local. 300 segundos é o valor padrão. Para obter mais informações, consulte Expiração e remoção (cache do Windows Server AppFabric).

6. Como opção, defina o atributo objectCount no elemento localCache para especificar o número máximo de objetos armazenados em cache local. O valor padrão é 10.000 objetos. Esse limite dispara o cliente de cache para começar a remover 20% dos objetos armazenados em cache local menos usados recentemente.

7. Como opção, se você estiver usando notificações de cache e desejar especificar um intervalo de sondagem que seja diferente do valor padrão de 300 segundos, adicione o elemento clientNotification como um filho do elemento dataCacheClient. Use o atributo pollInterval do elemento clientNotification para especificar o valor do intervalo de sondagem. Esse elemento e atributo poderão ser usados para especificar um intervalo de sondagem para notificações de cache mesmo se você não desejar usar o cache local.

Exemplo

Este exemplo mostra a aparência do elemento de cache local quando o cache local está habilitado. Esse elemento deve ser adicionado dentro do elemento dataCacheClient.

XML

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

Esse exemplo de arquivo de configuração de aplicativo tem o cache local habilitado e está configurado para apontar para um servidor de cache, CacheServer1. Para usar este exemplo, substitua o nome do servidor do exemplo pelo nome do seu servidor de cache. Adicione ou remova marcas de host conforme necessário para que fiquem adequadas ao seu ambiente.

Basicamente, especifique os hosts de cache que foram designados como hosts principais. Os hosts principais geralmente são os primeiros servidores de cache instalados no cluster. Para obter mais informações sobre hosts principais, consulte Diagrama de arquitetura física de cache do Windows Server AppFabric. Você pode determinar quais são os hosts principais usando a ferramenta de administração do Windows PowerShell. Para obter mais informações sobre o Windows PowerShell, consulte Usando o Windows PowerShell para gerenciar os recursos de cache do Windows Server AppFabric.

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>

Consulte também

Conceitos

Introdução a um cliente de cache (XML) do Windows Server AppFabric
Configurando um provedor de estado da sessão ASP.NET (Cache do Windows Server AppFabric)
Clientes de cache e cache local (Cache do Windows Server AppFabric)
Usando métodos de configuração (Cache do Windows Server AppFabric)
Conceitos de cache do Windows Server AppFabric
Desenvolvendo um cliente de cache (cache do Windows Server AppFabric)

  2011-12-05