Preparando o ambiente de desenvolvimento do cliente de cache

Artigo
03/05/2012

Este tópico descreve como preparar o seu projeto do Visual Studio para que você possa começar a desenvolver aplicativos habilitados para cache. Os procedimentos a seguir pressupõem que você já tenha instalado o Microsoft AppFabric 1.1 para Windows Server e configurado os recursos de Cache do AppFabric em um ou mais servidores de cache, formando um cluster de cache. Para obter mais informações, consulte Instalando o AppFabric 1.1.

Além de instalar os recursos de Cache do AppFabric, você deve executar as seguintes etapas antes que o cliente de cache possa acessar o cache:

No Windows PowerShell, use o Use-CacheCluster para colocar o contexto no cache de cluster de destino.
Crie todos os caches nomeados necessários com o comando New-Cache.
Conceda acesso à conta do Windows do cliente de cache com o comando Grant-CacheAllowedClientAccount.
Inicie o cluster de cache com o comando Start-CacheCluster.

Para obter mais informações sobre como usar o Windows PowerShell e os comandos listados aqui, consulte Usando o Windows PowerShell para gerenciar os recursos de cache do AppFabric 1.1.

Preparando o computador de desenvolvimento

Para desenvolver um aplicativo que usa os recursos de Cache do AppFabric, a única exigência de instalação é ter o recurso Cliente de AppFabric do AppFabric instalado. É possível desenvolver em um host de cache que tenha outros recursos de Cache do AppFabric instalados, mas o recurso de Cliente de Cache é a única exigência na estação de trabalho de desenvolvimento.

Preparando o projeto do Visual Studio

Os conjuntos necessários para o desenvolvimento de aplicativos habilitados para cache estão no diretório de instalação do Microsoft AppFabric 1.1 para Windows Server. O local padrão é .\Program Files\Windows Server AppFabric. Para desenvolver um aplicativo do Visual Studio .NET que utiliza esses conjuntos, você deve fazer referência a eles no seu projeto.

Para direcionar a versão correta do .NET Framework

Abra o seu projeto do Visual Studio .NET.
No Gerenciador de Soluções, clique com o botão direito no nome do projeto e selecione Propriedades.
Selecione a guia Aplicativo da caixa de diálogo Propriedades do Projeto.
Verifique se a versão da estrutura de destino é .NET Framework 2.0 ou superior.

Importante

Não use o perfil de cliente para a versão da estrutura de destino. No Visual Studio 2008, desmarque a caixa de seleção Subconjunto de estrutura de cliente apenas. No Visual Studio 2010, selecione as versões do .NET Framework que não especificam "Perfil de Cliente".

Para adicionar referências a conjuntos de Cache do AppFabric

Abra o seu projeto do Visual Studio .NET.
No Gerenciador de Soluções, clique com o botão direito no nome do projeto e, em seguida, selecione Adicionar Referência.
Selecione a guia Procurar da caixa de diálogo Adicionar Referência.
Navegue até o diretório de instalação do AppFabric (o padrão é .\Program Files\Windows Server AppFabric ).
Adicione uma referência aos dois conjuntos abaixo: Microsoft.ApplicationServer.Caching.Client.dll e Microsoft.ApplicationServer.Caching.Core.dll.
Existe a opção de adicionar a instrução de uso (Importa no Visual Basic) no topo dos arquivos de código para fazer referência ao namespace Microsoft.ApplicationServer.Caching.

Para configurar o cliente de cache

Determine as configurações de cliente apropriadas para o aplicativo cliente. Para saber mais sobre tipos de cliente de cache, consulte Clientes de cache e cache local (Cache do AppFabric v1.1).
Configure o seu cliente de cache através de um programa ou usando um arquivo de configuração de aplicativo. Para obter exemplos sobre como fazer isso, consulte Introdução a um cliente de cache e Introdução a um cliente de cache (XML). A lista completa de opções de cache de configuração do cliente é fornecida em Configurações de aplicativo (Cache do AppFabric 1.1).

Exemplo

Veja a seguir um exemplo de um cliente de cache configurado usando um arquivo de configuração de aplicativo. Neste exemplo, o cache local está desativada e dois hosts de cache estão listados: CacheServer1 e CacheServer2. Para obter mais informações, consulte Introdução a um cliente de cache (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"/>
         <host
            name="CacheServer2"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

Veja a seguir um exemplo de como configurar um cliente por programa. Neste exemplo, o cache local está desativada, lista apenas um servidor de cache (CacheServer2), e cria um cliente de cache para um cache chamado NamedCache1. Para obter mais informações, consulte Introdução a um cliente de cache.

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

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

' 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")

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

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

// 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

Configurações de aplicativo (Cache do AppFabric 1.1)
Como configurar um cliente de cache
Configuração de cliente baseado em XML
Configuração de cliente programático
Uso de métodos básicos de cache
Usando métodos de configuração
Conceitos de cache do AppFabric (Cache do AppFabric 1.1)

2012-03-05

Compartilhar via