Préparation de l'environnement de développement du client de cache (mise en cache d'AppFabric 1.1)

Article
03/05/2012

Cette rubrique décrit la préparation de votre projet Visual Studio pour commencer à développer des applications prenant en charge le cache. Les procédures suivantes supposent que vous avez déjà installé Microsoft AppFabric 1.1 pour Windows Server et configuré les fonctionnalités de Mise en cache d'AppFabric sur un ou plusieurs serveurs de cache, ce qui permet de former un cluster de cache. Pour plus d'informations, consultez la rubrique Installation d'AppFabric 1.1.

Outre l'installation des fonctionnalités de Mise en cache d'AppFabric, vous devez effectuer les opérations suivantes pour permettre au client de cache d'accéder au cache :

Dans Windows PowerShell, utilisez la commande Use-CacheCluster pour définir le contexte sur le cluster de cache cible.
Créez les caches nommés nécessaires à l'aide de la commande New-Cache.
Accordez l'accès au compte Windows du client de cache à l'aide de la commande Grant-CacheAllowedClientAccount.
Démarrez le cluster de cache à l'aide de la commande Start-CacheCluster.

Pour plus d'informations sur l'utilisation de Windows PowerShell et les commandes énumérées ici, consultez la rubrique Utilisation de Windows PowerShell pour la gestion des fonctionnalités de mise en cache d'AppFabric 1.1.

Préparation de l'ordinateur de développement

Pour développer une application basée sur les fonctionnalités de Mise en cache d'AppFabric, la fonctionnalité de client de cache d'AppFabric doit impérativement être installée. S'il est possible de développer des applications sur un hôte de cache sur lequel d'autres fonctionnalités de Mise en cache d'AppFabric sont installées, le client de cache est la seule fonctionnalité requise sur la station de travail de développement.

Préparation du projet Visual Studio

Les assemblys requis pour le développement d'applications prenant en charge le cache sont installés dans le répertoire de Microsoft AppFabric 1.1 pour Windows Server. L’emplacement par défaut est le dossier .\Program Files\Windows Server AppFabric. Pour développer une application .NET Visual Studio qui utilise ces assemblys, vous devez les référencer à partir de votre projet.

Pour cibler la bonne version du .NET Framework

Ouvrez votre projet .NET Visual Studio.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis sélectionnez Propriétés.
Sélectionnez l'onglet Application de la boîte de dialogue Propriétés du projet.
Vérifiez que la version cible est .NET Framework 2.0 ou ultérieur.

Important

N'utilisez pas le profil du client pour la version du .NET Framework cible Dans Visual Studio 2008, désactivez la case à cocher Sous-ensemble du Framework client seulement. Dans Visual Studio 2010, sélectionnez les versions du .NET Framework qui ne spécifient pas « Profil du client ».

Pour ajouter des références aux assemblys de Mise en cache d'AppFabric

Ouvrez votre projet .NET Visual Studio.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis sélectionnez Ajouter une référence.
Sélectionnez l'onglet Parcourir de la boîte de dialogue Ajouter une référence.
Accédez au répertoire d'installation d'AppFabric (situé par défaut dans .\Program Files\Windows Server AppFabric).
Ajoutez une référence aux assemblys suivants : Microsoft.ApplicationServer.Caching.Client.dll et Microsoft.ApplicationServer.Caching.Core.dll.
Ajoutez l'instruction Using (Imports dans Visual Basic) dans la partie supérieure des fichiers de code pour référencer l'espace de noms Microsoft.ApplicationServer.Caching (facultatif).

Pour configurer le client de cache

Déterminez les paramètres de client appropriés pour l'application cliente. Pour plus d'informations sur les types de clients de cache, consultez la rubrique Clients de cache et cache local (mise en cache d'AppFabric 1.1).
Configurez votre client de cache par programme ou à l'aide d'un fichier de configuration d'application. Pour obtenir des exemples de configuration, consultez les rubriques Prise en main du client de cache et Prise en main du client de cache (XML). La liste des options de configuration du client de cache est fournie dans la rubrique Paramètres de configuration des applications (mise en cache d'AppFabric 1.1).

Exemple

L'exemple suivant illustre la configuration d'un client de cache à l'aide d'un fichier de configuration d'application. Le cache local est désactivé et deux hôtes de cache sont répertoriés : CacheServer1 et CacheServer2. Pour plus d'informations, consultez la rubrique Prise en main du client 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>

L'exemple suivant illustre la configuration d'un client par programme. Le cache local est désactivé, référence un serveur de cache (CacheServer2) et crée un client de cache pour le cache nommé NamedCache1. Pour plus d'informations, consultez la rubrique Prise en main du client 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");

Voir aussi

Concepts

Paramètres de configuration des applications (mise en cache d'AppFabric 1.1)
Configuration d'un client de cache
Configuration du client basée sur un fichier XML
Configuration du client par programme
Utilisation des méthodes de cache basiques
Utilisation des méthodes de configuration
Concepts relatifs à la mise en cache d'AppFabric (mise en cache d'AppFabric 1.1)

2012-03-05

Partager via