Включение локального кэша Windows Server AppFabric (XML)

Windows Server AppFabric предоставляет возможность программной настройки клиента кэша или использования для этой цели файла конфигурации приложения. В приведенных в этом разделе процедурах описано, как включить локальный кэш на клиенте кэша при использовании файла конфигурации приложения на основе XML. Сведения о программном выполнении этой задачи см. в разделе Включение локального кэша Windows Server AppFabric.

В файле конфигурации приложения параметры локального кэша определяются в элементе localCache, который является дочерним элементом по отношению к dataCacheClient. Атрибут isEnabled элемента localCache определяет, включен локальный кэш или нет. Кроме того, элемент localCache может отсутствовать (или закомментирован), что означает отключенное состояние локального кэша. Дополнительные сведения о параметрах файла конфигурации приложения см. в разделе Параметры конфигурации приложения (кэширование в Windows Server AppFabric).

При выполнении этих процедур предполагается, что среда разработки уже подготовлена, заданы все ссылки на сборки кэширования AppFabric и т. д. Дополнительные сведения см. в разделе Подготовка среды разработки клиента кэша (кэширование в Windows Server AppFabric).

Чтобы включить локальный кэш с помощью файла конфигурации приложения

1. Создайте файл конфигурации приложения с именем App.config и добавьте его в проект. Дополнительные сведения см. в разделе Начало работы с клиентом кэша Windows Server AppFabric (XML).

2. Добавьте элемент localCache в качестве дочернего в элемент dataCacheClient.

3. Задайте значение атрибута isEnabled элемента localCache равным true, чтобы задействовать локальный кэш.

4. Задайте значение атрибута sync элемента localCache. Задайте для этого атрибута значение TimeoutBased, чтобы использовать время ожидания для ограничения срока действия локального кэша. Используйте объект NotificationBased для дополнительного использования уведомления кэша о недействительности локального кэша. Для функционирования параметра NotificationsBased необходимо включить уведомления для именованного кэша. Дополнительные сведения см. в разделе Уведомления кэша (кэширование в Windows Server AppFabric).

5. Задайте для атрибута ttlValue элемента localCache значение, равное необходимому количеству секунд, в течение которого объекты должны оставаться в локальном кэше. По умолчанию используется значение 300 секунд. Дополнительные сведения см. в разделе Окончание срока действия и вытеснение (кэширование в Windows Server AppFabric).

6. Кроме того, задайте значение для атрибута objectCount элемента localCache, чтобы указать максимальное количество объектов, сохраняемых в локальном кэше. По умолчанию значение равно 10 000 объектов. Это пороговое значение приводит к тому, что клиент кэша исключает из локального кэша 20 процентов наименее используемых объектов.

7. Кроме того, если используются уведомления и необходимо указать интервал опроса, отличающийся от значения по умолчанию, равного 300 секундам, добавьте элемент clientNotification в качестве дочернего по отношению к элементу dataCacheClient. Используйте атрибут pollInterval элемента clientNotification для указания значения интервала опроса. Этот элемент и атрибут могут использоваться для указания интервала опроса для уведомлений кэша, даже если нет необходимости использовать локальный кэш.

Пример

В этом примере показано, как выглядит элемент задействованного локального кэша. Этот элемент должен быть добавлен в рамках элемента dataCacheClient.

XML

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

В этом примере в файле конфигурации приложения включен локальный кэш с указанием на один сервер кэша CacheServer1. Чтобы использовать этот пример, замените имя сервера в примере на имя используемого сервера кэша. Добавьте или удалите теги узла в соответствии с потребностями среды.

В идеале следует указать те узлы кэша, которые были назначены ведущими узлами кэша. Как правило, ведущие узлы — это первые серверы кэша, установленные в кластере. Дополнительные сведения о ведущих узлах см. в разделе Схема физической архитектуры кэширования Windows Server AppFabric. Можно определить, какие узлы являются ведущими, используя средство администрирования Windows PowerShell. Дополнительные сведения о Windows PowerShell см. в разделе Использование Windows PowerShell для управления компонентами кэширования в 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>

См. также

Основные понятия

Начало работы с клиентом кэша Windows Server AppFabric (XML)
Настройка поставщика состояний сеансов ASP.NET (кэширование в Windows Server AppFabric)
Клиенты кэша и локальный кэш (кэширование в Windows Server AppFabric)
Использование методов настройки (кэширование в Windows Server AppFabric)
Основные принципы кэширования Windows Server AppFabric
Разработка клиента кэша (кэширование в Windows Server AppFabric)

  2011-12-05