Habilitar cache local (XML)

O Microsoft AppFabric 1.1 para Windows Server oferece a opção para configurar um cliente de cache programaticamente ou com um arquivo de configuração do 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 AppFabric 1.1.

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 definições de configuração de aplicativo, consulte Configurações de aplicativo (Cache do AppFabric 1.1).

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.

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).

  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 AppFabric 1.1).

  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 Expiration and Eviction (AppFabric 1.1 Caching).

  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 são, geralmente 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 AppFabric (Cache do AppFabric 1.1). Você pode determinar quais hosts serão hosts principais, utilizando a ferramenta de administração do Windows PowerShell. Para obter mais informações sobre o Windows PowerShell, consulte Administração de cache com o Windows PowerShell (AppFabric 1.1).

Dica

O Visual Basic pode, em primeiro lugar, adicionar elementos automaticamente ao arquivo de configuração do aplicativo. Esses elementos adicionais não serão exigidos pelos recursos de cache do AppFabric e poderão ser excluídos se você não precisar mais deles para o seu aplicativo.

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

Conceitos de cache do AppFabric (Cache do AppFabric 1.1)

  2012-03-05