Partager via

Prise en main du client de cache

  • Article

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 suivantes décrivent la configuration par programme d'un client de cache utilisé par votre application. Pour plus d'informations sur l'exécution de ces procédures à l'aide d'un fichier de configuration d'application, consultez la rubrique Prise en main du client de cache (XML).

Pour configurer votre client de cache par programme, créez une instance de la classe DataCacheFactoryConfiguration pour spécifier les paramètres de configuration. Transmettez ensuite cet objet au constructeur de classe DataCacheFactory.

Conseil

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.

Notes

Ces procédures partent du principe que vous avez déjà préparé votre environnement de développement pour utiliser les fonctionnalités de client de cache. 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 par programme

  1. Créez un tableau d'objets DataCacheServerEndpoint pour spécifier les hôtes de cache du client.

  2. Créez une instance de la classe DataCacheFactoryConfiguration.

  3. Configurez vos hôtes de cache en affectant le tableau d'hôtes de cache créé lors de la première étape à la propriété Servers de l'objet DataCacheFactoryConfiguration.

  4. Transmettez l'objet DataCacheFactoryConfiguration au constructeur de la classe DataCacheFactory.

  5. Utilisez la méthode GetDefaultCache ou GetCache pour obtenir une classe DataCache basée sur les paramètres de l'objet DataCacheFactoryConfiguration.

Exemple

Cet exemple montre la configuration par programme d'un client de cache pour le cache nommé NamedCache1. Le cache local est désactivé et le client de cache est configuré pour pointer vers le serveur de cache CacheServer2. Pour utiliser cet exemple dans votre application, remplacez les propriétés du serveur dans l'exemple par celles de votre ou vos serveurs de cache. Ajoutez d'autres objets DataCacheServerEndpoint au tableau servers pour chacun des autres hôtes de cache dans le cluster.

Spécifiez 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).

Commencez par créer le tableau servers. Cet exemple décrit la configuration de l'hôte de cache CacheServer2.

' Declare array for cache host(s).
Dim servers(0) As DataCacheServerEndpoint
servers(0) = New DataCacheServerEndpoint("CacheServer2", 22233)

// Declare array for cache host(s).
DataCacheServerEndpoint[] servers = new DataCacheServerEndpoint[1];
servers[0] = new DataCacheServerEndpoint("CacheServer2", 22233);

Créez un objet DataCacheFactoryConfiguration. Affectez le tableau servers à la propriété Servers.

' Setup the DataCacheFactory configuration.
Dim factoryConfig As DataCacheFactoryConfiguration
factoryConfig = New DataCacheFactoryConfiguration
factoryConfig.Servers = servers

// Setup the DataCacheFactory configuration.
DataCacheFactoryConfiguration factoryConfig = new DataCacheFactoryConfiguration();
factoryConfig.Servers = servers;

Transmettez l'objet DataCacheFactoryConfiguration au constructeur de classe DataCacheFactory et instanciez le client de cache avec la méthode GetCache. Cet exemple crée le client de cache NamedCache1.

' 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")

// 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

Activation du cache local d'AppFabric 1.1
Clients de cache et cache local (mise en cache d'AppFabric 1.1)

  2012-03-05