Erste Schritte mit einem Cacheclient (XML)

Artikel
03/05/2012

Microsoft AppFabric 1.1 für Windows Server bietet die Möglichkeit, den Cacheclient programmgesteuert oder mithilfe einer Anwendungskonfigurationsdatei zu konfigurieren. Die Vorgehensweisen in diesem Thema beschreiben, wie ein Cacheclient für eine Anwendung mithilfe einer XML-basierten Anwendungskonfigurationsdatei konfiguriert wird. Informationen zur programmgesteuerten Aktivierung finden Sie unter Erste Schritte mit einem Cacheclient.

Weitere Informationen zu den Anwendungskonfigurationseinstellungen finden Sie unter Anwendungskonfigurationseinstellungen (AppFabric 1.1-Cache).

Für diese Vorgehensweise wird angenommen, dass die Entwicklungsumgebung bereits vorbereitet wurde, die Verweise auf die AppFabric-Cache-Assemblys festgelegt wurden usw. Weitere Informationen finden Sie unter Vorbereiten der Cacheclient-Entwicklungsumgebung (AppFabric 1.1-Cache).

So konfigurieren Sie einen Cacheclient mithilfe einer Anwendungskonfigurationsdatei

Wählen Sie in Visual Studio im Menü Projekt den Befehl Neues Element hinzufügen aus.
Wählen Sie Anwendungskonfigurationsdatei aus, benennen Sie die Datei App.config, und klicken Sie dann auf Hinzufügen.
Fügen Sie das XML-Beispiel im folgenden Abschnitt in die <configuration>-Tags der Datei App.config ein. Ihre Anwendung kann die Anwendungskonfigurationsdatei für andere Zwecke verwenden, achten Sie jedoch in jedem Fall darauf, dass das Element configSections immer das erste Element unter dem Tag configuration bleibt.
Aktualisieren Sie host-Elemente für die Cachehosts, oder fügen Sie diese hinzu, je nach den Gegebenheiten Ihrer Umgebung. Für jeden Eintrag:
- Verwenden Sie das name-Attribut, um den Computernamen des Cachehosts anzugeben.
- Verwenden Sie das cachePort-Attribut, um die Cacheportnummer des Hosts anzugeben.
Erstellen Sie im Code ein DataCacheFactory-Objekt unter Verwendung des Standardkonstrukts. Wenn keine Konfigurationsparameter an das DataCacheFactory-Objekt übergeben werden, verwendet die Anwendung die Konfigurationseinstellungen in der App.config-Datei.
Verwenden Sie die GetCache-Methode zum Erstellen eines DataCache-Objekts, um mit der Verwendung eines Cacheclients zu beginnen.

Beispiel

Dieses Beispiel für eine Anwendungskonfigurationsdatei ist so konfiguriert, dass sie auf zwei Server, CacheServer1 und CacheServer2, verweist. Ersetzen Sie die Servernamen in diesem Beispiel durch die Namen Ihrer Cacheserver. Fügen Sie je nach den Anforderungen Ihrer Umgebung Hosttags hinzu, oder entfernen Sie sie.

Geben Sie idealerweise 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 (AppFabric 1.1-Cache).

Mit dem Windows PowerShell-Verwaltungstool können Sie festlegen, welche Hosts als führende Hosts fungieren sollen. Weitere Informationen zur Windows PowerShell finden Sie unter Verwenden von Windows PowerShell zum Verwalten von AppFabric 1.1-Cachefunktionen.

Hinweis

Möglicherweise fügt Visual Basic Ihrer Anwendungskonfigurationsdatei zunächst automatisch Elemente hinzu. Diese zusätzlichen Elemente werden von den Cachefunktionen von AppFabric nicht benötigt und können gelöscht werden, wenn sie nicht für andere Anwendungsfunktionen erforderlich sind.

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

Nach dem Festlegen der Cacheclient-Konfigurationseinstellungen in der Anwendungskonfigurationsdatei können Sie mit der Programmierung Ihrer cacheaktivierten Anwendung beginnen. In diesem Beispiel wird ein DataCacheFactory-Objekt mit dem Namen CacheFactory1 mithilfe des Standardkonstruktors erstellt. Da die Cacheclient-Konfigurationseinstellungen nicht an den ersten Parameter des DataCacheFactory-Konstruktors übergeben werden, wird der Cacheclient auf der Grundlage der in der Anwendungskonfigurationsdatei angegebenen Einstellungen konfiguriert.

Hinweis

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.

Im nächsten Schritt wird die GetCache-Methode verwendet, um ein DataCache-Objekt mit dem Namen myCache1 zu erstellen. Anschließend wird die Add-Methode aufgerufen, um dem Cache ein Objekt hinzuzufügen.

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

Siehe auch

Konzepte

Aktivieren des lokalen Caches (XML)
Cacheclients und lokaler Cache (AppFabric 1.1-Cache)
Verwenden von Konfigurationsmethoden
AppFabric-Cachekonzepte (AppFabric 1.1-Cache)
Entwickeln eines Cacheclients

Weitere Ressourcen

So wird es gemacht: Erste Schritte mit einem Routingclient (XML)
So wird es gemacht: Konfigurieren eines Sitzungsstatusanbieters (XML)

2012-03-05

Freigeben über