Introdução a um cliente de cache do Windows Server AppFabric
O Windows Server AppFabric oferece a opção para configurar o cliente de cache de forma programática ou com um arquivo de configuração de 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) do Windows Server AppFabric.
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 motivos de desempenho, é recomendável minimizar 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 usam clientes de cache.
Observação
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 (Cache do Windows Server AppFabric).
Para configurar um cliente de cache de forma programática
Crie uma matriz de objetos DataCacheServerEndpoint para especificar os hosts de cache do cliente.
Crie uma instância da classe DataCacheFactoryConfiguration.
Configure os hosts de cache atribuindo a matriz do host de cache da primeira etapa até a propriedade
Servers
do objeto DataCacheFactoryConfiguration.Passe o objeto DataCacheFactoryConfiguration para o construtor da classe DataCacheFactory.
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 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.
Primeiro, a matriz servers
é criada. Este exemplo configura um host de cache com o 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 com o nome 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 Windows Server AppFabric
Alterar o nível de log do cliente de cache (cache do Windows Server AppFabric)
Clientes de cache e cache local (Cache do Windows Server AppFabric)
Conceitos de cache do Windows Server AppFabric
Desenvolvendo um cliente de cache (cache do Windows Server AppFabric)
Outros recursos
Configurando o cliente de cache com XML
2011-12-05