Introdução a um cliente de cache (XML)

Artigo
03/05/2012

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

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, 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 configurar um cliente de cache usando um arquivo de configuração do aplicativo

No menu Projeto no Visual Studio, selecione Adicionar novo item.
Selecione Arquivo de configuração do aplicativo, nomeie o arquivo App.config e clique em Adicionar.
Cole o exemplo XML na seção a seguir dentro das marcas <configuration> do seu arquivo App.config. Seu aplicativo pode usar o arquivo de configuração do aplicativo para outros fins, mas verifique se o elemento configSections continua sendo o primeiro elemento na marca configuration.
Atualize ou adicione elementos host para os hosts de cache, conforme apropriado para seu ambiente. Para cada um:
- Use o atributo name para especificar o nome do computador do host de cache.
- Use o atributo cachePort para especificar o número da porta do cache do host.
No seu código, crie um objeto DataCacheFactory usando a construção padrão. Ao não passar os parâmetros de configuração para o objeto DataCacheFactory, seu aplicativo usará as definições de configuração no arquivo App.config.
Para começar a usar o cliente de cache, use o método GetCache para criar um objeto DataCache.

Exemplo

Esse arquivo de configuração do aplicativo de exemplo está configurado para apontar para dois servidores, CacheServer1 e CacheServer2. Substitua os nomes de servidor neste exemplo pelos nomes dos seus servidores de cache. Adicione ou remova marcas de host conforme necessário para que fiquem adequadas ao seu ambiente.

De forma ideal, 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 Usando o Windows PowerShell para gerenciar os recursos de cache do AppFabric 1.1.

Dica

O Visual Basic pode primeiro adicionar automaticamente elementos ao seu 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 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>
      <hosts>
         <host
            name="CacheServer1"
            cachePort="22233"/>
         <host
            name="CacheServer2"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

Depois de especificar as definições de configuração do cliente de cache no arquivo de configuração do aplicativo, comece a programar seu aplicativo habilitado para cache. Este exemplo cria um objeto DataCacheFactory chamado CacheFactory1 usando o construtor padrão. Como as definições de configuração do cliente de cache não são passadas para o primeiro parâmetro do construtor DataCacheFactory, o cliente de cache será configurado com base nas configurações especificadas no arquivo de configuração do aplicativo.

Dica

Por motivos de desempenho, recomendamos que você reduza o número de objetos DataCacheFactory criados em um aplicativo habilitado para cache. Armazene o objeto DataCacheFactory em uma variável disponível para todas as partes do aplicativo que utilizam o clientes de cache.

Em seguida, o método GetCache é usado para criar um objeto DataCache chamado myCache1. Assim, o método Add é chamado para adicionar um objeto ao cache.

' Use configuration from the application configuration file.
Dim CacheFactory1 As DataCacheFactory = New DataCacheFactory()

' Get cache client for cache "NamedCache1".
Dim myCache1 As DataCache = CacheFactory1.GetCache("NamedCache1")

' Add an object to the cache.
myCache1.Add("helloKey", "hello world")

// Use configuration from the application configuration file.
DataCacheFactory CacheFactory1 = new DataCacheFactory();

// Get cache client for cache "NamedCache1".
DataCache myCache1 = CacheFactory1.GetCache("NamedCache1");

// Add an object to the cache.
myCache1.Add("helloKey", "hello world");

Consulte também

Conceitos

Habilitar cache local (XML)
Clientes de cache e cache local (Cache do AppFabric v1.1)
Usando métodos de configuração
Conceitos de cache do AppFabric (Cache do AppFabric 1.1)
Desenvolvendo um cliente de cache

Outros recursos

Como: Introdução a um cliente de cache (XML)
Como: Configurar um provedor de estado da sessão (XML)

2012-03-05

Partilhar via