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

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

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

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

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

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

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

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

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

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

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. Чтобы использовать этот пример, замените имя сервера в примере на имя используемого сервера кэша. Добавьте или удалите теги узла в соответствии с потребностями среды.

В идеале следует указать те узлы кэша, которые были назначены ведущими узлами кэша. Как правило, ведущие узлы — это первые серверы кэша, установленные в кластере. Дополнительные сведения о ведущих узлах см. в разделе Схема физической архитектуры кэширования AppFabric (кэширование в AppFabric 1.1). Можно определить, какие узлы являются ведущими, используя средство администрирования Windows PowerShell. Дополнительные сведения о Windows PowerShell см. в разделе Администрирование кэша с помощью Windows PowerShell (AppFabric 1.1).

Примечание

Поначалу Visual Basic может автоматически добавлять элементы в файл конфигурации приложения. Эти дополнительные элементы не являются обязательными для использования функций кэширования в 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>

См. также

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

Основные принципы кэширования AppFabric (кэширование в AppFabric 1.1)

  2012-03-05