Ejemplo de uso de la API de almacenamiento en caché de Windows Server AppFabric

En este ejemplo se muestra el modo de usar diversas API de caché de AppFabric.

Nota

Los ejemplos se proporcionan únicamente con fines de aprendizaje. No están concebidos para su uso en un entorno de producción ni se han probado en este tipo de entorno. Microsoft no proporciona asistencia técnica para estos ejemplos.

Requisitos previos

Preferiblemente, los usuarios deben estar familiarizados con el lenguaje de scripting de Windows PowerShell.

Para el ejemplo se supone lo siguiente:

• Windows PowerShell 2.0 está instalado.

• Windows Server AppFabric está instalado. (Esto agrega los archivos .DLL necesarios a la GAC).

Configuración de la caché de AppFabric

Si todavía no lo ha hecho, configure la caché de AppFabric mediante la herramienta de configuración de Windows Server AppFabric (use la configuración predeterminada). En el ejemplo se supone que se ha configurado una memoria caché de AppFabric con las opciones predeterminadas (cacheHostName=AppFabricCachingService y cacheName=default).

Inicio del clúster de caché

1. Abra una ventana de comandos de Windows PowerShell en un modo con privilegios elevados y ejecute el comando siguiente para agregar el módulo de administración de caché distribuida:

   Import-Module DistributedCacheAdministration
   

2. Use el comando Use-CacheCluster para establecer el contexto de la sesión de Windows PowerShell en el clúster de caché deseado. Puede ejecutarlo sin parámetros para usar los parámetros de conexión proporcionados durante la configuración del componente de administración de almacenamiento en caché de AppFabric.

3. Ejecute el siguiente comando para conceder a la cuenta de usuario acceso al clúster de caché como cliente. Indique el nombre de usuario y de dominio.

   Grant-CacheAllowedClientAccount domain\username
   

4. Use el comando Get-CacheAllowedClientAccounts para comprobar si se ha concedido acceso a la cuenta de usuario.

5. Inicie el clúster con el comando Start-CacheCluster.

Generación y ejecución de este ejemplo

1. Abra el archivo de solución CacheAPI.sln en Visual Studio. El ejemplo se vincula automáticamente con los archivos DLL de la memoria caché de AppFabric Microsoft.ApplicationServer.Caching.Client.dll y Microsoft.ApplicationServer.Caching.Core.dll) de la GAC. El ejemplo muestra los patrones de uso siguientes:

   • Remove/Create en una región con nombre;

   • Sólo Add/Get en la memoria caché o región predeterminada;

   • Add/Get en una región con nombre de la memoria caché predeterminada;

   • Add/Get/GetAndLock/GetIfNewer/Put/PutAndUnlock en una región con nombre. Variaciones:

     • GetAndLock al intentar obtener acceso a un objeto bloqueado;

     • PutAndUnlock al intentar desbloquear un objeto que no está bloqueado;

   • Add/Get/Put en un objeto con versión;

     • Modificar explícitamente un elemento sólo si coinciden las versiones;

     • Error al modificar un elemento si en la memoria caché existe un elemento más reciente;

   • Sólo Add/GetByTag para mostrar el uso de etiquetas.

   Nota

   Para cada ejecución subsiguiente de este ejemplo, use el comando Restart-CacheCluster para borrar la memoria caché y espere entre 10 y 15 segundos.

Eliminación de este ejemplo

Reinicie el clúster de caché mediante el comando Restart-CacheCluster para limpiar los datos de la memoria caché.

Vea también

Otros recursos

Ejemplos de almacenamiento en caché de Windows Server AppFabric

  2011-12-05