Introducción al cliente de caché (XML)

Microsoft AppFabric 1.1 para Windows Server ofrece la opción de configurar el cliente de caché mediante programación o con un archivo de configuración de aplicación. Los procedimientos descritos en este tema explican cómo configurar un cliente de caché para su aplicación mediante un archivo de configuración de aplicación basado en XML. Para obtener información sobre cómo hacerlo mediante programación, vea Introducción al cliente de caché.

Para obtener más información acerca de los parámetros de configuración de la aplicación, vea Opción de configuración de la aplicación (Almacenamiento en caché de AppFabric 1.1).

En estos procedimientos se supone que ya preparó el entorno de desarrollo y configuró las referencias para los ensamblados de Almacenamiento en caché de AppFabric, etcétera. Para obtener más información, vea Preparación del entorno de desarrollo de clientes de caché (Almacenamiento en caché de AppFabric 1.1).

Procedimiento para configurar un cliente de caché mediante un archivo de configuración de la aplicación

1. En el menú Proyecto de Visual Studio, seleccione Agregar nuevo elemento.

2. Seleccione Archivo de configuración de aplicaciones, denomine el archivo app.config y, a continuación, haga clic en Agregar.

3. Pegue el ejemplo de XML en la siguiente sección dentro de las etiquetas de <configuration> de su archivo App.config. La aplicación puede usar el archivo de configuración de aplicación para otros propósitos, pero debe asegurarse de que el elemento configSections es siempre el primero bajo la etiqueta configuration.

4. Actualice o agregue elementos host para los hosts de la caché según corresponda para su entorno. Para cada uno:

   • Use el atributo name para especificar el nombre de equipo del host de caché.

   • Use el atributo cachePort para especificar el número de puerto del host.

5. En el código, cree un objeto de DataCacheFactory mediante la construcción predeterminada. Al no pasar parámetros de configuración al objeto DataCacheFactory, la aplicación usará las opciones de configuración del archivo App.config.

6. Para empezar a usar el cliente de caché, use el método GetCache para crear un objeto DataCache.

Ejemplo

Este archivo de configuración de la aplicación de ejemplo está configurado para apuntar a dos servidores, CacheServer1 y CacheServer2. Reemplace los nombres de servidor de este ejemplo con los de los servidores de caché. Agregue o quite etiquetas de host según sea necesario para adecuar el entorno.

Idealmente, especifique esos hosts de caché que se han designado como hosts principales. Los hosts principales suelen ser los primeros servidores de caché instalados en el clúster. Para obtener más información acerca de los hosts principales, vea el Diagrama de la arquitectura física de AppFabric (Almacenamiento en caché de AppFabric 1.1).

Puede determinar qué hosts son principales mediante la herramienta de administración de Windows PowerShell. Para obtener más información sobre Windows PowerShell, vea Uso de Windows PowerShell para administrar características de almacenamiento en caché de AppFabric 1.1.

Nota

Es posible que al principio Visual Basic agregue automáticamente elementos al archivo de configuración de aplicación. Esos elementos adicionales no son necesarios para las características de almacenamiento en caché de AppFabric y se pueden eliminar si no los necesita para nada más en la aplicación.

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

Después de haber especificado las opciones de configuración del cliente de caché en el archivo de configuración de la aplicación, empiece a programar la aplicación habilitada para la caché. En este ejemplo se crea un objeto denominado DataCacheFactory denominado CacheFactory1 usando el constructor predeterminado. Puesto que las opciones de configuración del cliente de caché no se pasan al primer parámetro del constructor DataCacheFactory, el cliente de caché se configurará en función de los valores especificados en el archivo de configuración de la aplicación.

Nota

Por razones de rendimiento, recomendamos reducir el número de objetos DataCacheFactory creados en una aplicación habilitada para caché. Almacenar el objeto DataCacheFactory en una variable disponible para todas las partes de la aplicación que usan los clientes de la caché.

A continuación, el método GetCache se usa para crear un objeto DataCache , denominado myCache1. A continuación, se llama al método Add para agregar un objeto a la caché.

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

Vea también

Conceptos

Habilitación de la memoria caché local (XML)
Clientes de caché y caché local (Almacenamiento en caché de AppFabric 1.1)
Uso de métodos de configuración
Conceptos de almacenamiento en caché de AppFabric (Almacenamiento en caché de AppFabric 1.1)
Desarrollar un cliente de caché

Otros recursos

Procedimiento: introducción al cliente de enrutamiento (XML)
Procedimiento: configuración de proveedores de estado de sesión (XML)

  2012-03-05