Erste Schritte mit einem Windows Server AppFabric-Cacheclient

Artikel
12/05/2011

Windows Server AppFabric bietet die Möglichkeit, den Cacheclient programmgesteuert oder mithilfe einer Anwendungskonfigurationsdatei zu konfigurieren. Mit den folgenden Verfahren wird beschrieben, wie Sie einen von Ihrer Anwendung verwendeten Cacheclient programmgesteuert konfigurieren. Informationen, wie dies mit einer Anwendungskonfigurationsdatei durchgeführt wird, finden Sie unter Erste Schritte mit einem Windows Server AppFabric-Cacheclient (XML).

Wenn Sie den Cacheclient programmgesteuert konfigurieren möchten, erstellen Sie eine Instanz der DataCacheFactoryConfiguration-Klasse, um die Konfigurationseinstellungen anzugeben. Übergeben Sie anschließend dieses Objekt an den DataCacheFactory-Klassenkonstruktor.

Tipp

Aus Leistungsgründen wird empfohlen, die Anzahl der DataCacheFactory-Objekte, die in einer cacheaktivierten Anwendung erstellt werden, möglichst gering zu halten. Speichern Sie das DataCacheFactory-Objekt in einer Variablen, die für alle Teile der Anwendung, die einen Cacheclient verwenden, zugänglich ist.

Hinweis

Bei diesen Verfahren wird davon ausgegangen, dass Sie die Entwicklungsumgebung bereits für die Verwendung der Cacheclientfeatures vorbereitet haben. Weitere Informationen finden Sie unter Vorbereiten der Cacheclient-Entwicklungsumgebung (Windows Server AppFabric-Cache).

So konfigurieren Sie einen Cacheclient programmgesteuert

Erstellen Sie ein Array aus DataCacheServerEndpoint-Objekten, um die Cachehosts für den Client anzugeben.
Erstellen Sie eine Instanz der DataCacheFactoryConfiguration-Klasse.
Konfigurieren Sie die Cachehosts, indem Sie das Cachehostarray aus dem ersten Schritt der Servers-Eigenschaft des DataCacheFactoryConfiguration-Objekts zuweisen.
Übergeben Sie das DataCacheFactoryConfiguration-Objekt an den Konstruktor der DataCacheFactory-Klasse.
Verwenden Sie die GetDefaultCache-Methode oder die GetCache-Methode, um eine DataCache-Klasse basierend auf den Einstellungen des DataCacheFactoryConfiguration-Objekts zu erhalten.

Beispiel

In diesem Beispiel wird die programmgesteuerte Konfiguration eines Cacheclients für einen Cache mit Namen NamedCache1 gezeigt. Bei diesem Cacheclient ist der lokale Cache deaktiviert, und er ist so konfiguriert, dass er auf einen Cacheserver mit Namen CacheServer2 verweist. Wenn Sie dieses Beispiel in Ihrer Anwendung verwenden möchten, ersetzen Sie die Servereigenschaften in diesem Beispiel durch die Ihres oder Ihrer Cacheserver. Fügen Sie dem servers-Array für jeden der weiteren Cachehosts im Cluster zusätzliche DataCacheServerEndpoint-Objekte hinzu.

Geben Sie die Cachehosts an, die als führende Hosts festgelegt wurden. Als führende Hosts fungieren in der Regel die ersten Cacheserver, die im Cluster installiert wurden. Weitere Informationen zu führenden Hosts finden Sie unter Diagramm der physischen Windows Server AppFabric-Cachearchitektur. Mit dem Windows PowerShell-Verwaltungstool können Sie festlegen, welche Hosts als führende Hosts fungieren sollen. Weitere Informationen zu Windows PowerShell finden Sie unter Verwenden von Windows PowerShell zum Verwalten von Windows Server AppFabric-Cachefeatures.

Zuerst wird das servers-Array erstellt. In diesem Beispiel wird ein Cachehost mit Namen CacheServer2 konfiguriert.

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

Erstellen Sie als Nächstes ein DataCacheFactoryConfiguration-Objekt. Weisen Sie das servers-Array der Servers-Eigenschaft zu.

' 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;

Übergeben Sie im nächsten Schritt das DataCacheFactoryConfiguration-Objekt an den DataCacheFactory-Klassenkonstruktor, und instanziieren Sie den Cacheclient mit der GetCache-Methode. In diesem Beispiel wird ein Cacheclient für einen Cache mit Namen NamedCache1 erstellt.

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

Siehe auch

Konzepte

Aktivieren des lokalen Caches in Windows Server AppFabric
Ändern des Cacheclient-Protokolliergrads (Windows Server AppFabric-Cache)
Cacheclients und lokaler Cache (Windows Server AppFabric-Cache)
Windows Server AppFabric-Cachekonzepte
Entwickeln eines Cacheclients (Windows Server AppFabric-Cache)

Weitere Ressourcen

Konfigurieren des Cacheclients mit XML

2011-12-05

Freigeben über