Partager via

Activation du cache local (XML)

  • Article

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

Dans le fichier de configuration de l'application, les paramètres de cache local sont définis dans l'élément localCache, lequel est un enfant de l'élément dataCacheClient. L'attribut isEnabled de l'élément localCache détermine si le cache local est activé ou non. L'élément localCache peut également être manquant (ou commenté) pour indiquer qu'il est désactivé. 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'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).

Activation du cache local à l'aide d'un fichier de configuration d'application

  1. Créez le fichier de configuration d'application App.config et ajoutez-le à votre projet. Pour plus d'informations, consultez la rubrique Prise en main du client de cache (XML).

  2. Ajoutez l'élément localCache en tant qu'enfant de l'élément dataCacheClient.

  3. Définissez l'attribut isEnabled de l'élément localCache sur la valeur true pour activer le cache local.

  4. Définissez l'attribut sync de l'élément localCache. Définissez cet attribut sur l'option TimeoutBased pour utiliser un délai d'expiration pour l'invalidation du cache local. Utilisez l'option NotificationBased pour utiliser les notifications de cache lors de l'invalidation du cache local. L'option NotificationsBased nécessite l'activation des notifications de cache sur le cache nommé. Pour plus d'informations, consultez la rubrique Notifications de cache (mise en cache d'AppFabric 1.1).

  5. Définissez l'attribut ttlValue de l'élément localCache sur le nombre de secondes pendant lequel les objets doivent être conservés dans le cache local. La valeur par défaut est 300 secondes. Pour plus d'informations, consultez la rubrique Expiration et éviction (mise en cache d'AppFabric 1.1).

  6. Définissez l'attribut objectCount de l'élément localCache pour spécifier le nombre maximal d'objets mis en cache localement (facultatif). La valeur par défaut est 10,000 objets. Ce seuil déclenche l'éviction de 20 % des objets les moins récemment utilisés mis en cache localement.

  7. Si vous utilisez les notifications de cache et souhaitez spécifier une valeur de fréquence d'interrogation différente de la valeur par défaut (300 secondes), ajoutez l'élément clientNotification en tant qu'enfant de l'élément dataCacheClient (facultatif). Utilisez l'attribut pollInterval de l'élément clientNotification pour spécifier la nouvelle valeur de fréquence d'interrogation. Cet élément et cet attribut peuvent être utilisés pour spécifier une fréquence d'interrogation pour les notifications de cache, même si vous ne souhaitez pas utiliser le cache local.

Exemple

Cet exemple montre l'élément de cache local lorsque le cache local est activé. Cet élément doit être ajouté dans l'élément dataCacheClient.

XML

<!-- local cache enabled -->
<localCache
  isEnabled="true"
  sync="TimeoutBased"
  objectCount="100000"
  ttlValue="300" />

Dans l'exemple suivant, le cache local est activé et le fichier de configuration de l'application pointe vers le serveur de cache CacheServer1. Pour utiliser cet exemple, remplacez le nom du serveur défini par celui de votre serveur 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 Administration du cache avec Windows PowerShell (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

<?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"/>
      </hosts>
   </dataCacheClient>
</configuration>

Voir aussi

Concepts

Concepts relatifs à la mise en cache d'AppFabric (mise en cache d'AppFabric 1.1)

  2012-03-05