Compartir vía

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

  • 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. En los siguientes procedimientos se describe cómo habilitar la memoria caché local en el cliente de caché mediante programación. Para obtener más información acerca de cómo hacer esto mediante el archivo de configuración de la aplicación, vea Habilitación de la memoria caché local de Windows Server AppFabric (XML).

En los siguientes pasos se describe el proceso necesario para habilitar mediante programación la memoria caché local para el cliente de caché:

  1. Cree una instancia de la clase DataCacheLocalCacheProperties. Configure la memoria caché local. Para ello, transfiera los valores correspondientes a los parámetros del constructor. Entre ellos se incluyen objectCount, defaultTimeout e invalidationPolicy.

  2. Transfiera el objeto DataCacheLocalCacheProperties al constructor de un nuevo objeto DataCacheFactory.

  3. Use el objeto DataCacheFactory para llamar al método GetCache y crear un cliente de caché que use la memoria caché local.

WarningAdvertencia
En estos procedimientos se supone que ya preparó el entorno de desarrollo y configuró las referencias para los ensamblados de caché de AppFabric. 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 crear un cliente de caché con la memoria caché local habilitada

  1. Cree una matriz de objetos DataCacheServerEndpoint para especificar los hosts de caché para el cliente.

  2. Cree una instancia de la clase DataCacheLocalCacheProperties. Configure la memoria caché local. Para ello, transfiera los valores correspondientes a los parámetros del constructor.

    1. Use el parámetro objectCount para especificar el número máximo de objetos en la memoria caché local.

    2. Use el parámetro defaultTimeout para especificar un objeto System.TimeSpan que determine el tiempo que permanecerá un objeto en la memoria caché local antes de invalidarse.

    3. Use el parámetro invalidationPolicy para especificar cómo se invalidan los objetos en la memoria caché local. Especifique DataCacheLocalCacheInvalidationPolicy.TimeoutBased para indicar que solamente se debe usar el valor de tiempo de espera. Especifique DataCacheLocalCacheInvalidationPolicy.NotificationBased para indicar que se usarán notificaciones de caché además de tiempos de espera. Para obtener más información, vea Clientes de caché y caché local (Almacenamiento en caché de Windows Server AppFabric).

  3. Si seleccionó DataCacheLocalCacheInvalidationPolicy.NotificationBased para la directiva de invalidación, tiene la opción de controlar el intervalo de sondeo sobre la frecuencia con la que el cliente de caché se comunica con el clúster de caché para las actualizar las notificaciones de los objetos en la memoria caché local. Para ello, cree una instancia de la clase DataCacheNotificationProperties. Configure las opciones de notificación. Para ello, transfiera los valores correspondientes a los parámetros del constructor.

    1. Use el parámetro PollInterval para especificar un objeto System.Timespan para el intervalo de frecuencia según el que el cliente de caché comprobará el clúster de caché en búsqueda de notificaciones de caché. Tenga en cuenta que no se requiere memoria caché local para las notificaciones de caché. Para obtener más información, vea Notificaciones de caché (Almacenamiento en caché de Windows Server AppFabric).

    2. El parámetro MaxQueueLength controla la longitud de la cola para ver si hay notificaciones, pero no afecta específicamente a la memoria caché local. El valor predeterminado es 16384.

  4. Cree una instancia de la clase DataCacheFactoryConfiguration.

  5. Configure los hosts de caché. Para ello, asigne la matriz del host de caché del primer paso a la propiedad Servers del objeto DataCacheFactoryConfiguration.

  6. Configure la memoria caché local. Para ello, asigne el objeto DataCacheLocalCacheProperties creado en el segundo paso a la propiedad LocalCacheProperties del objeto DataCacheFactoryConfiguration.

  7. En caso necesario, configure las propiedades de notificación. Para ello, asigne el objeto DataCacheLocalNotificationProperties creado en el segundo paso a la propiedad NotificationProperties del objeto DataCacheFactoryConfiguration.

  8. Transfiera el objeto DataCacheFactoryConfiguration al constructor de la clase DataCacheFactory.

  9. Use el método GetCache para obtener una clase DataCache basada en la configuración del objeto DataCacheFactoryConfiguration.

Nota

Si seleccionó DataCacheLocalCacheInvalidationPolicy.NotificationBased para la directiva de invalidación de caché local, la memoria caché de destino debe estar configurada para tener las notificaciones habilitadas. Para obtener más información, vea Uso de Windows PowerShell para administrar características de almacenamiento en caché de Windows Server AppFabric.

Ejemplo

En este ejemplo se muestra la configuración mediante programación de un cliente de caché que tiene la memoria caché local habilitada. Este cliente se configura para usar una memoria caché denominada NamedCache1 y señala a un servidor de caché denominado CacheServer2. Para usar el ejemplo en la aplicación propia, reemplace las propiedades del servidor en este ejemplo por las de los servidores de caché. Agregue objetos DataCacheServerEndPoint adicionales a la matriz de servidores para cada uno de los demás hosts de caché del clúster.

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 sobre Windows PowerShell, vea Uso de Windows PowerShell para administrar características de almacenamiento en caché de Windows Server AppFabric. En primer lugar, se crea la matriz de servidores. En este ejemplo se configura un host de caché denominado CacheServer2.

' Declare array for cache host(s).
Dim servers(0) As DataCacheServerEndpoint
servers(0) = New DataCacheServerEndpoint("CacheServer2", 22233)

// Declare array for cache host(s).
DataCacheServerEndpoint[] servers = new DataCacheServerEndpoint[1];
servers[0] = new DataCacheServerEndpoint("CacheServer2", 22233);

A continuación, cree un objeto DataCacheLocalCacheProperties. En este ejemplo, la caché local se crea con el número de objetos 10000 y un tiempo de espera de 30 segundos.

' Set the local cache properties. In this example, it
' is timeout-based with a timeout of 30 seconds.
Dim localCacheConfig As DataCacheLocalCacheProperties
Dim localTimeout As TimeSpan = New TimeSpan(0, 0, 30)

localCacheConfig = New DataCacheLocalCacheProperties(10000, _
   localTimeout, DataCacheLocalCacheInvalidationPolicy.TimeoutBased)

// Set the local cache properties. In this example, it
// is timeout-based with a timeout of 30 seconds.
DataCacheLocalCacheProperties localCacheConfig;
TimeSpan localTimeout = new TimeSpan(0, 0, 30);

localCacheConfig = new DataCacheLocalCacheProperties(10000, 
   localTimeout, DataCacheLocalCacheInvalidationPolicy.TimeoutBased);

A continuación, cree un objeto DataCacheFactoryConfiguration. Asigne la matriz servers a la propiedad Servers. Asigne el objeto localCacheConfig a la propiedad LocalCacheProperties.

' Setup the DataCacheFactory configuration.
Dim factoryConfig As DataCacheFactoryConfiguration
factoryConfig = New DataCacheFactoryConfiguration

factoryConfig.Servers = servers
factoryConfig.LocalCacheProperties = localCacheConfig

// Setup the DataCacheFactory configuration.
DataCacheFactoryConfiguration factoryConfig = 
   new DataCacheFactoryConfiguration();

factoryConfig.Servers = servers;
factoryConfig.LocalCacheProperties = localCacheConfig;

A continuación, transfiera el objeto DataCacheFactoryConfiguration al constructor de clase DataCacheFactory y cree una instancia del cliente de caché con el método GetCache. En este ejemplo se crea un cliente de caché para una memoria caché denominada NamedCache1.

' Create a configured DataCacheFactory object.
Dim mycacheFactory As DataCacheFactory
mycacheFactory = New DataCacheFactory(factoryConfig)

' Get a cache client for the cache "NamedCache1".
Dim myDefaultCache As DataCache
myDefaultCache = mycacheFactory.GetCache("NamedCache1")

// Create a configured DataCacheFactory object.
DataCacheFactory mycacheFactory = new DataCacheFactory(factoryConfig);

// Get a cache client for the cache "NamedCache1".
DataCache myDefaultCache = mycacheFactory.GetCache("NamedCache1");

Nota

Para evitar problemas de rendimiento, es recomendable minimizar el número de objetos DataCacheFactory creados en aplicaciones habilitadas para caché. Almacene el objeto DataCacheFactory en una variable que esté disponible para todas las partes de la aplicación que usen clientes de caché.

Vea también

Conceptos

Introducción al cliente de caché de Windows Server AppFabric
Modificación del nivel de registro del cliente de caché (Almacenamiento en caché de Windows Server AppFabric)
Clientes de caché y caché local (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)

Otros recursos

Configuración del cliente caché mediante XML

  2011-12-05