Habilitación de la memoria caché local de Windows Server AppFabric (XML)

Windows Server AppFabric ofrece la opción de configurar un cliente de caché mediante programación o con un archivo de configuración de aplicación. En los procedimientos de este tema se describe cómo habilitar la memoria caché local en el cliente de caché cuando se usa un archivo XML de configuración de la aplicación. Para obtener información acerca de cómo hacerlo mediante programación, vea Habilitación de la memoria caché local de Windows Server AppFabric.

En el archivo de configuración de aplicaciones, los parámetros de caché local se definen en el elemento localCache, un elemento secundario del elemento dataCacheClient. El atributo isEnabled del elemento localCache determina si la memoria caché local está habilitada o no. De forma alternativa, puede faltar el elemento localCache (o haberse convertido en comentario), lo que indica que está deshabilitado. 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 ya preparó el entorno de desarrollo y configuró las referencias para los ensamblados de 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 Windows Server AppFabric).

Procedimiento para habilitar la memoria caché local con un archivo de configuración de la aplicación

1. Cree el archivo de configuración de la aplicación, denominado App.config, y agréguelo al proyecto. Para obtener más información, vea Introducción al cliente de caché de Windows Server AppFabric (XML).

2. Agregue el elemento localCache como elemento secundario del elemento dataCacheClient.

3. Establezca el atributo isEnabled del elemento localCache igual a true para habilitar la memoria caché local.

4. Establezca el atributo sync del elemento localCache. Establezca el atributo en TimeoutBased para usar un tiempo de espera de invalidación de la memoria caché local. Use NotificationBased para usar, además, notificaciones de caché para invalidar la memoria caché local. La opción NotificationsBased necesita que habilite las notificaciones de caché en la memoria caché con nombre. Para obtener más información, vea Notificaciones de caché (Almacenamiento en caché de Windows Server AppFabric).

5. Establezca el atributo ttlValue del elemento localCache igual al número de segundos que desee que los objetos permanezcan en la memoria caché local. El valor predeterminado es de 300 segundos. Para obtener más información, vea Caducidad y expulsión (Almacenamiento en caché de Windows Server AppFabric).

6. Opcionalmente, establezca el atributo objectCount del elemento localCache para que especifique el número máximo de objetos almacenados en caché local. El valor predeterminado es 10,000 objetos. Este umbral desencadena que el cliente de caché empiece a expulsar el 20 por ciento de los objetos almacenados en caché local usados hace más tiempo.

7. Opcionalmente, si usa notificaciones de caché y desea especificar un intervalo de sondeo diferente del valor predeterminado de 300 segundos, agregue el elemento clientNotification como elemento secundario del elemento dataCacheClient. Use el atributo pollInterval del elemento clientNotification para especificar el valor de intervalo de sondeo. Este elemento y atributo se pueden usar para especificar un intervalo de sondeo de las notificaciones de caché aunque no desee usar la memoria caché local.

Ejemplo

En este ejemplo se muestra el aspecto del elemento de caché local cuando se habilita la memoria caché local. Este elemento se debe agregar dentro del elemento dataCacheClient.

XML

<!-- local cache enabled -->
<localCache
  isEnabled="true"
  sync="TimeoutBased"
  objectCount="100000"
  ttlValue="300" />

Este ejemplo de archivo de configuración de la aplicación tiene la memoria caché local habilitada y está configurado para apuntar a un servidor de caché, CacheServer1. Para usar este ejemplo, reemplace el nombre de servidor del ejemplo por el nombre del servidor de caché. Agregue o quite las etiquetas de host según necesite para ajustarse al entorno.

De forma ideal, especifique los hosts de caché que se designaron 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.

XML

<?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>
      <!-- (optional) specify local cache -->
      <localCache
         isEnabled="true"
         sync="TimeoutBased"
         objectCount="100000"
         ttlValue="300" />

      <!--(optional) specify cache notifications poll interval
      <clientNotification pollInterval="300" /> -->

      <hosts>
         <host
            name="CacheServer1"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

Vea también

Conceptos

Introducción al cliente de caché 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