Preparación del entorno de desarrollo de clientes de caché (Almacenamiento en caché de AppFabric 1.1)

Artículo
03/05/2012

En este tema se describe cómo preparar el proyecto de Visual Studio de modo que pueda comenzar a desarrollar aplicaciones habilitadas para caché. En los siguientes procedimientos se supone que ya instaló Microsoft AppFabric 1.1 para Windows Server y configuró las características de Almacenamiento en caché de AppFabric en uno o más servidores de caché, creando un clúster de caché. Para obtener más información, vea Instalación de AppFabric 1.1.

Además de instalar las características de Almacenamiento en caché de AppFabric, debe realizar los siguientes pasos para que el cliente de caché pueda obtener acceso a la memoria caché:

En Windows PowerShell, use Use-CacheCluster para establecer el contexto al clúster de caché de destino.
Cree las memorias caché con nombre necesarias mediante el comando New-Cache.
Conceda acceso a la cuenta de Windows del cliente de caché mediante el comando Grant-CacheAllowedClientAccount.
Inicie el clúster de caché mediante el comando Start-CacheCluster.

Para obtener más información sobre Windows PowerShell y los comandos que se muestran aquí, vea Uso de Windows PowerShell para administrar características de almacenamiento en caché de AppFabric 1.1.

Preparación del equipo de desarrollo

Para desarrollar una aplicación que use las características de Almacenamiento en caché de AppFabric, el único requisito de instalación es tener instalada la característica Cliente de caché de AppFabric. Se puede desarrollar un host de caché que tenga instaladas otras características de Almacenamiento en caché de AppFabric, pero la característica Cliente de caché es el único requisito en la estación de trabajo de desarrollo.

Preparación del proyecto de Visual Studio

Los ensamblados necesarios para desarrollar aplicaciones habilitadas para caché se encuentran en el directorio de instalación de Microsoft AppFabric 1.1 para Windows Server. La ubicación predeterminada es .\Program Files\Windows Server AppFabric. Para desarrollar una aplicación de Visual Studio .NET que use estos ensamblados, debe hacer referencia a ellos desde el proyecto.

Procedimiento para destinar la versión correcta de .NET Framework

Abra el proyecto de Visual Studio .NET.
En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto y seleccione Propiedades.
Seleccione la pestaña Aplicación del cuadro de diálogo Propiedades del proyecto.

Verifique que la versión del marco de destino sea .NET Framework 2.0 o superior.

Importante
No use el perfil de cliente para la versión del marco de destino. En Visual Studio 2008, desactive la casilla de verificación Subconjunto de .Net Framework solo de cliente. En Visual Studio 2010, seleccione versiones de .NET Framework que no especifiquen "Client Profile".

Procedimiento para agregar referencias a los ensamblados de Almacenamiento en caché de AppFabric

Abra el proyecto de Visual Studio .NET.
En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto y seleccione Agregar referencia.
Seleccione la pestaña Examinar del cuadro de diálogo Agregar referencia.
Desplácese hasta el directorio de instalación de AppFabric (de manera predeterminada este directorio es: .\Program Files\Windows Server AppFabric ).
Agregue una referencia a los dos ensamblados siguientes: Microsoft.ApplicationServer.Caching.Client.dll y Microsoft.ApplicationServer.Caching.Core.dll.
De manera opcional, agregue la declaración de uso (importaciones en Visual Basic) a la parte superior de los archivos de código para hacer referencia al espacio de nombres de Microsoft.ApplicationServer.Caching.

Procedimiento para configurar el cliente de caché

Determine la configuración de cliente adecuada para la aplicación cliente. Para obtener más información sobre el cliente de caché, vea Clientes de caché y caché local (Almacenamiento en caché de AppFabric 1.1).
Configure el cliente de caché mediante programación o mediante un archivo de configuración de la aplicación. Para ver ejemplos acerca de cómo hacerlo, vea Introducción al cliente de caché y Introducción al cliente de caché (XML). La lista completa de opciones de configuración del cliente de caché se proporciona en Opción de configuración de la aplicación (Almacenamiento en caché de AppFabric 1.1).

Ejemplo

A continuación se muestra un ejemplo de un cliente de caché configurado mediante un archivo de configuración de la aplicación. En este ejemplo, la memoria caché local está deshabilitada y se muestran dos hosts de caché: CacheServer1 y CacheServer2. Para obtener más información, consulte Introducción al cliente de caché (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"/>
         <host
            name="CacheServer2"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

A continuación se muestra un ejemplo de cómo configurar un cliente mediante programación. En este ejemplo, la memoria caché local está deshabilitada, se muestra un solo servidor de caché (CacheServer2) y se crea un cliente de caché para una memoria caché denominada NamedCache1. Para obtener más información, consulte Introducción al cliente de caché.

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

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

' 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")

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

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

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

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

Vea también

Conceptos

Opción de configuración de la aplicación (Almacenamiento en caché de AppFabric 1.1)
Configuración de un cliente de caché
Configuración de cliente basada en XML
Configuración de clientes mediante programación
Uso de los métodos de caché básicos
Uso de métodos de configuración
Conceptos de almacenamiento en caché de AppFabric (Almacenamiento en caché de AppFabric 1.1)

2012-03-05

Compartir vía