Prise en main du client de cache (XML)

Article
03/05/2012

Microsoft AppFabric 1.1 pour Windows Server permet de configurer le client de cache par programme ou à l'aide d'un fichier de configuration d'application. Les procédures de cette rubrique décrivent la configuration d'un client de cache pour votre application à l'aide d'un fichier de configuration d'application XML. Pour plus d'informations sur la configuration par programme, consultez la rubrique Prise en main du client de cache.

Pour plus d'informations sur les paramètres de configuration d'application, consultez la rubrique Paramètres de configuration des applications (mise en cache d'AppFabric 1.1).

Ces procédures partent du principe que vous avez déjà préparé votre environnement de développement, défini les références aux assemblys de Mise en cache d'AppFabric, etc. Pour plus d'informations, consultez la rubrique Préparation de l'environnement de développement du client de cache (mise en cache d'AppFabric 1.1).

Pour configurer un client de cache à l'aide d'un fichier de configuration d'application

Dans le menu Projet de Visual Studio, sélectionnez Ajouter un nouvel élément.
Sélectionnez l'option Fichier de configuration de l'application, nommez le fichier App.config, puis cliquez sur Ajouter.
Collez le code XML d'exemple dans la section suivante à l'intérieur des balises <configuration> du fichier App.config. Votre application peut utiliser le fichier de configuration d'application à d'autres fins. Vérifiez toutefois que l'élément configSections demeure toujours en première position sous la balise configuration.
Mettez à jour ou ajoutez des éléments host pour les hôtes de cache, selon les spécificités de votre environnement. Pour chaque hôte :
- Utilisez l'attribut name pour spécifier le nom d'ordinateur de l'hôte de cache.
- Utilisez l'attribut cachePort pour spécifier le numéro de port de cache de l'hôte.
Dans le code, créez un objet DataCacheFactory sur le modèle de construction par défaut. Si les paramètres de configuration ne sont pas transmis à l'objet DataCacheFactory, votre application utilise les paramètres de configuration du fichier App.config.
Pour commencer à utiliser le client de cache, utilisez la méthode GetCache pour créer un objet DataCache.

Exemple

Dans l'exemple suivant, le fichier de configuration de l'application pointe vers deux serveurs (CacheServer1 et CacheServer2). Remplacez les noms de serveur de l'exemple par ceux de vos serveurs de cache. Ajoutez ou supprimez des balises d'hôte selon les spécificités de votre environnement.

Dans l'idéal, vous devez spécifier les hôtes de cache désignés comme hôtes principaux. Les hôtes principaux sont généralement les premiers serveurs de cache installés dans le cluster. Pour plus d'informations sur les hôtes principaux, consultez la rubrique Diagramme de l'architecture physique de mise en cache d'AppFabric (mise en cache d'AppFabric 1.1).

Vous pouvez identifier les hôtes principaux à l'aide de l'outil d'administration Windows PowerShell. Pour plus d'informations sur Windows PowerShell, consultez la rubrique Utilisation de Windows PowerShell pour la gestion des fonctionnalités de mise en cache d'AppFabric 1.1.

Notes

Il se peut que Visual Basic ajoute automatiquement des éléments au fichier de configuration de votre application. Ces éléments ne sont pas requis par les fonctionnalités de mise en cache d'AppFabric et peuvent être supprimés si vous n'en avez pas besoin pour votre application.

<?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>
      <hosts>
         <host
            name="CacheServer1"
            cachePort="22233"/>
         <host
            name="CacheServer2"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

Une fois les paramètres de configuration du client de cache spécifiés dans le fichier de configuration de l'application, vous pouvez commencer à programmer votre application prenant en charge le cache. Cet exemple crée un objet DataCacheFactory nommé CacheFactory1 qui utilise le constructeur par défaut. Étant donné que les paramètres de configuration du client de cache ne sont pas transmis au premier paramètre du constructeur DataCacheFactory, le client de cache utilise les paramètres du fichier de configuration de l'application.

Notes

Il est recommandé de réduire le nombre d'objets DataCacheFactory créés dans une application prenant en charge le cache afin d'optimiser les performances. Stockez l'objet DataCacheFactory dans une variable accessible à toutes les parties de l'application qui utilisent des clients de cache.

La méthode GetCache permet ensuite de créer un objet DataCache nommé myCache1. Enfin, la méthode Add est appelée pour ajouter un objet au cache.

' Use configuration from the application configuration file.
Dim CacheFactory1 As DataCacheFactory = New DataCacheFactory()

' Get cache client for cache "NamedCache1".
Dim myCache1 As DataCache = CacheFactory1.GetCache("NamedCache1")

' Add an object to the cache.
myCache1.Add("helloKey", "hello world")

// Use configuration from the application configuration file.
DataCacheFactory CacheFactory1 = new DataCacheFactory();

// Get cache client for cache "NamedCache1".
DataCache myCache1 = CacheFactory1.GetCache("NamedCache1");

// Add an object to the cache.
myCache1.Add("helloKey", "hello world");

Voir aussi

Concepts

Activation du cache local (XML)
Clients de cache et cache local (mise en cache d'AppFabric 1.1)
Utilisation des méthodes de configuration
Concepts relatifs à la mise en cache d'AppFabric (mise en cache d'AppFabric 1.1)
Développement d'un client de cache

Autres ressources

Prise en main d'un client de routage (XML)
Configuration d'un fournisseur d'état de session (XML)

2012-03-05

Partager via