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

Microsoft AppFabric 1.1 para Windows Server 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 sobre cómo hacerlo mediante programación, vea Habilitar la memoria caché local de AppFabric 1.1.

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 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 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é (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 AppFabric 1.1).

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 AppFabric 1.1).

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 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 Administración de caché con Windows PowerShell (AppFabric 1.1).

Nota

Al principio, Visual Basic puede agregar elementos automáticamente al archivo de configuración de la aplicación. Estos 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

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

Conceptos de almacenamiento en caché de AppFabric (Almacenamiento en caché de AppFabric 1.1)

  2012-03-05