Compartir vía

Introducción al cliente de caché de Windows Server AppFabric (XML)

  • Artículo

Windows Server AppFabric 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 acerca de cómo hacerlo mediante programación, vea Introducción al cliente de caché de Windows Server AppFabric.

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

En estos procedimientos se supone que el usuario ya ha preparado el entorno de desarrollo y ha establecido las referencias a los ensamblados de almacenamiento en caché de AppFabric, entre otros. Para obtener más información, vea Preparación del entorno de desarrollo de clientes de caché (Almacenamiento en caché de Windows Server AppFabric).

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 Diagrama de la arquitectura física de almacenamiento en caché de Windows Server AppFabric.

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

Nota

Es posible que al principio Visual Basic agregue automáticamente elementos al archivo de configuración de aplicación. Estos elementos adicionales no son imprescindibles para las características de almacenamiento en caché de AppFabric y pueden eliminarse si no los necesita para su 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

Introducción al cliente de caché de Windows Server AppFabric (XML)
Habilitación de la memoria caché local de Windows Server AppFabric (XML)
Configuración de proveedores de estado de sesión ASP.NET (Almacenamiento en caché de Windows Server AppFabric)
Clientes de caché y caché local (Almacenamiento en caché de Windows Server AppFabric)
Uso de métodos de configuración (almacenamiento en caché de Windows Server AppFabric)
Conceptos de almacenamiento en caché de Windows Server AppFabric
Desarrollo de un cliente de caché (Almacenamiento en caché de Windows Server AppFabric)

  2011-12-05