Estenda a classe DataCacheStoreProvider (Cache do AppFabric 1.1)

Este tópico descreve como criar um provedor read-through/escrita atrasada para Cache do Windows Server AppFabric. Crie um provedor impla‏‎ntando a classe abstrata básica DataCacheStoreProvider.

Crie o projeto do provedor

1. No Visual Studio 2010, crie um novo projeto Biblioteca de classes.

2. Adicione uma referência ao assembly Microsoft.ApplicationServer.Core.dll. Por padrão, esse assembly fica localizado em .\Arquivos de Programas\Windows Server AppFabric.

3. Abra o arquivo de origem para esse projeto, que é Class1.cs ou Class1.vb, dependendo do idioma do projeto.

4. Na parte superior do arquivo de origem, adicione um demonstrativo em uso (Importações no Visual Basic) ao namespace Microsoft.ApplicationServer.Caching.

   using Microsoft.ApplicationServer.Caching;
   

   Imports Microsoft.ApplicationServer.Caching
   

5. Modifique a classe para que ela seja herdada de DataCacheStoreProvider. Observe que o editor de códigos do Visual Studio 2010 fornece um recurso para a criação automática de funções vazias a partir dessa classe. No Visual C#, clique com o botão direito do mouse na classe DataCacheStoreProvider e selecione Implementar classe abstrata. No Visual Basic, pressione Enter após a linha Herdar.

   namespace RTProvider
   {
       public class Provider : DataCacheStoreProvider
   

   Public Class Provider
       Inherits DataCacheStoreProvider
   

6. Assine o assembly para instalá-lo no Cache de Assembly Global com um nome forte. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Propriedades. Na seção Assinatura das propriedades do projeto, marque a caixa de seleção Assinar o assembly. Na lista suspensa Escolher arquivo de chave com nome forte, selecione um arquivo de chave existente ou selecione <Novo...> para criar um.

Adicione um construtor público

Cada provedor deve implementar um construtor público com a seguinte assinatura:

public ProviderClass(string cacheName, Dictionary<string,string> config)

Substitua ProviderClass no exemplo acima com o nome da sua classe que implementa os métodos de DataCacheStoreProvider. Esse construtor será chamado quando um cache habilitar primeiro read-through ou escrita atrasada em um host de cache em execução. Ele também será chamado todas as vezes que um host de cache for reiniciado. O construtor adota os dois parâmetros a seguir:

Implemente os métodos do provedor

Os métodos da classe DataCacheStoreProvider precisam ser implementados pelo provedor. Observe que se você estiver criando apenas um provedor read-through, não será necessário implementar os métodos "Gravação". Da mesma forma, se você estiver criando apenas um provedor escrita atrasada, não será necessário implementar os métodos "Leitura".

Os nomes dos métodos geralmente descrevem os seus objetivos. A tabela a seguir descreve os métodos sem incluir as sobrecargas.

Há dois métodos de leitura. O primeiro método Leitura é transmitido por um parâmetro DataCacheItemKey que identifica o item único de será retornado. A outra sobrecarga Leitura é transmitida por um conjunto de objetos DataCacheItemKey para recuperar e transmitir de volta em um Dictionary de objetos DataCacheItemKey e DataCacheItem. Inicialmente, esse objeto de dicionário fica vazio e os itens de leitura precisam ser adicionados antes do retorno a partir do método Leitura. Observe que se você precisa usar a classe DataCacheItemFactory para criar os itens solicitados de acordo com o exemplo a seguir.

DataCacheItem dataCacheItem = DataCacheItemFactory.GetCacheItem(key, CACHE_NAME, objectValue, null);

No exemplo anterior, a cadeia de caracteres CACHE_NAME deve ter sido definida com o nome do cache transmitido anteriormente para o construtor sobrecarregado. A key é a DataCacheItemKey solicitada. O objectValue é o objeto que deve ser retornado aos clientes dessa chave de cache.

Da mesma forma, há dois métodos de gravação. O primeiro método Gravação é transmitido por um objeto DataCacheItem. Observe que a propriedade Key do objeto contém a DataCacheItemKey associada, e a propriedade Value contém o valor. O outro método Gravação é transmitido por um Dictionary de objetos DataCacheItemKey e DataCacheItem.

Tratamento de Erros

Se não houver erros, você poderá gerar um objeto de exceção DataCacheStoreException. O resultado dessa exceção poderá variar se a exceção ocorrer durante o método Read ou o método Write. A tabela a seguir descreve essas diferenças.

Há três valores DataCacheErrorCode possíveis que um cliente de cache pode receber durante chamadas de DataCache.Get que acessam o provedor read-through.

1. DataCacheErrorCode.ReadThroughProviderFailure

2. DataCacheErrorCode.ReadThroughProviderDidNotReturnResult

3. DataCacheErrorCode.ReadThroughProviderNotFound

Observe também que o tempo gasto nos métodos Leitura do provedor é adicionado ao tempo de solicitação total do método DataCache.Get. Por isso, talvez seja necessário aumentar o tempo limite de solicitação para a contabilização de qualquer atraso apresentado pelo provedor. Para obter mais informações, consulte Configurando tempos limites do cliente de cache (cache do Windows Server AppFabric).

Como testar e depurar o provedor

Para desenvolvimento e teste, é recomendável configurar um cluster de cache de nó único na máquina de desenvolvimento. Isso permite que você recompile rapidamente, adicione novamente o assembly ao Cache de Assembly Global e reinicie o cluster de cache local. As etapas a seguir mostram como depurar o provedor.

1. Abra o projeto do provedor em Visual Studio 2010.

2. No menu Depurar, clique em Anexar ao processo.

3. Marque Mostrar processos de todos os usuários e Mostrar processo em todas as sessões.

4. Selecione o processo DistributedCacheService.exe.

5. Clique no botão Anexar.

6. Defina os pontos de interrupção no código do seu provedor e realize as operações no cache a partir de outro aplicativo que resulte na chamada de métodos do provedor.

Consulte também

Conceitos

Implante um provedor read-through/escrita atrasada (Cache do AppFabric v1.1)
Enable Read-Through and Write-Behind on a Cache (AppFabric 1.1 Caching)

  2012-03-05