Introdução a um cliente de cache

  • Artigo

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 a seguir descrevem como configurar de forma programática um cache de cliente usado pelo aplicativo. Para obter informações sobre como fazer isso com um arquivo de configuração de aplicativo, consulte Introdução a um cliente de cache (XML).

Para configurar de forma programática o seu cliente de cache, crie uma instância da classe DataCacheFactoryConfiguration para especificar as definições de configuração. Em seguida, passe esse objeto para o construtor de classe DataCacheFactory.

Dica

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

Dica

Esses procedimentos supõem que você já tenha preparado seu ambiente de desenvolvimento para usar os recursos do Cliente de Cache. Para obter mais informações, consulte Preparando o ambiente de desenvolvimento do cliente de cache.

Para configurar um cliente de cache de forma programática

  1. Crie uma matriz de objetos DataCacheServerEndpoint para especificar os hosts de cache para o cliente.

  2. Crie uma instância da classe DataCacheFactoryConfiguration.

  3. Configure seus hosts de cache atribuindo a matriz de host de cache da primeira etapa à propriedade Servers do objeto DataCacheFactoryConfiguration.

  4. Transmita o objeto DataCacheFactoryConfiguration ao construtor da classeDataCacheFactory.

  5. Use o método GetDefaultCache ou GetCache para obter uma classe DataCache baseada nas configurações do objeto DataCacheFactoryConfiguration.

Exemplo

Este exemplo mostra a configuração programática de um cliente de cache para um cache com o nome NamedCache1. Esse cliente de cache tem o cache local desabilitado e está configurado para indicar um servidor de cache com o nome CacheServer2. Para usar esse exemplo em seu próprio aplicativo, substitua as propriedades do servidor contidas nesse exemplo por aquelas de seus servidores de cache. Adicione outros objetos DataCacheServerEndpoint à matriz servers para cada um dos outros hosts de cache do cluster.

Especifique os hosts de cache aos quais foram designados 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).

Primeiro, a matriz servers é criada. Este exemplo configura um host de cache cujo nome é CacheServer2.

' Declare array for cache host(s).
Dim servers(0) As DataCacheServerEndpoint
servers(0) = New DataCacheServerEndpoint("CacheServer2", 22233)

// Declare array for cache host(s).
DataCacheServerEndpoint[] servers = new DataCacheServerEndpoint[1];
servers[0] = new DataCacheServerEndpoint("CacheServer2", 22233);

Em seguida, crie um objeto DataCacheFactoryConfiguration. Atribua a matriz servers à propriedade Servers.

' Setup the DataCacheFactory configuration.
Dim factoryConfig As DataCacheFactoryConfiguration
factoryConfig = New DataCacheFactoryConfiguration
factoryConfig.Servers = servers

// Setup the DataCacheFactory configuration.
DataCacheFactoryConfiguration factoryConfig = new DataCacheFactoryConfiguration();
factoryConfig.Servers = servers;

Em seguida, passe o objeto DataCacheFactoryConfiguration para o construtor de classe DataCacheFactory e instancie o cliente de cache com o método GetCache. Este exemplo cria um cliente de cache para um cache denominado NamedCache1.

' Create a configured DataCacheFactory object.
Dim mycacheFactory As DataCacheFactory
mycacheFactory = New DataCacheFactory(factoryConfig)

' Get a cache client for the cache "NamedCache1".
Dim myDefaultCache As DataCache
myDefaultCache = mycacheFactory.GetCache("NamedCache1")

// Create a configured DataCacheFactory object.
DataCacheFactory mycacheFactory = new DataCacheFactory(factoryConfig);

// Get a cache client for the cache "NamedCache1".
DataCache myDefaultCache = mycacheFactory.GetCache("NamedCache1");

Consulte também

Conceitos

Habilitar cache local do AppFabric 1.1
Clientes de cache e cache local (Cache do AppFabric v1.1)

  2012-03-05