Preparando o ambiente de desenvolvimento do cliente de cache (Cache do Windows Server AppFabric)

Artigo
12/05/2011

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 Windows Server AppFabric e configurado os recursos de cache do AppFabric em um ou mais servidores de cache, ou em sua estação de trabalho de desenvolvimento. Para obter mais informações, consulte o Guia de Instalação do Windows Server AppFabric (https://go.microsoft.com/fwlink/?LinkId=169172).

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 Windows Server AppFabric.

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 Cache 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 são instalados no cache global de conjuntos (global assembly cache, GAC). 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 .\Windows\System32\AppFabric.

Observação

Em sistemas operacionais de 64 bits, o diretório AppFabric não poderá ser visto diretamente. Para contornar esse problema, substitua o nome do diretório System32 pelo nome Sysnative. Isso leva à navegação até o diretório :\Windows\SysNative\AppFabric nesta etapa.
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 Windows Server AppFabric).
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 do Windows Server AppFabric e Introdução a um cliente de cache (XML) do Windows Server AppFabric.

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) do Windows Server AppFabric.

<?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 do Windows Server AppFabric.

' 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

Outros recursos

Configurando o cliente de cache com XML

2011-12-05

Compartilhar via