アプリケーション構成設定 (Windows Server AppFabric キャッシング)

Windows Server AppFabric のキャッシュ機能では、アプリケーションのキャッシュ クライアント設定をプログラムやアプリケーション構成ファイルを使用して構成できます。アプリケーションの場所に応じて両方のやり方を使い分けることもできます。これらの構成方法とそれぞれの選択方法の詳細については、「クライアント構成オプション (Windows Server AppFabric キャッシュ)」を参照してください。

どちらの方法を使用する場合でも、構成する対象は同じキャッシュ クライアント設定です。このトピックの表に、キャッシュ クライアントで利用できる設定、およびそれぞれを XML ベースのアプリケーション構成ファイルで構成する方法と、コードを使用してプログラムから構成する方法を示します。

アプリケーションでこれらの設定を使用する方法の詳細については、「XML ベースのクライアント構成 (Windows Server AppFabric キャッシュ)」の例を参照してください。

キャッシュ クライアント設定

キャッシュ ホスト設定

クラスター内のキャッシュ ホストは、キャッシュ クライアントごとに 1 台以上指定する必要があります。リード ホストに指定されているキャッシュ ホストはクラスターの管理に役立つため、リード ホストを指定してください。リード ホストはクラスターにインストールされる最初のキャッシュ ホストです。リード ホストの詳細については、「Windows Server AppFabric キャッシュの物理アーキテクチャ図」を参照してください。

アプリケーション構成ファイルでは、各キャッシュ ホストの設定は host 要素で指定します。これは、hosts 要素の子です。プログラムからは、各ホストを DataCacheServerEndpoint クラスのクラス コンストラクターで定義します。それらがインスタンス化された後、DataCacheServerEndPoint オブジェクトは DataCacheServerEndpoint クラスの Servers プロパティに渡されます。

ローカル キャッシュ設定

ローカル キャッシュ設定では、ローカル キャッシュを有効にするかどうか、ローカルにキャッシュされたオブジェクトを無効にする方法、オブジェクト タイムアウト、およびローカルにキャッシュされたオブジェクトを無効にするためにキャッシュ通知を使用するかどうかを指定します。

アプリケーション構成ファイルでは、ローカル キャッシュ設定は localCache 要素で定義します。これは、dataCacheClient 要素の子です。プログラムからローカル キャッシュを構成するには、DataCacheFactoryConfiguration クラスのインスタンスを使用し、このインスタンスを DataCacheFactory クラス コンストラクターのコンストラクターに渡します。ローカル キャッシュの詳細については、「キャッシュ クライアントとローカル キャッシュ (Windows Server AppFabric キャッシング)」を参照してください。

通知の設定

アプリケーション構成ファイルでは、通知プロパティは clientNotification 要素で定義します。これは、dataCacheClient 要素の子です。プログラムから通知プロパティを構成するには、DataCacheFactoryConfiguration クラスのインスタンスを使用し、このインスタンスを DataCacheFactory クラス コンストラクターのコンストラクターに渡します。詳細については、「構成メソッド (Windows Server AppFabric キャッシュ)」を参照してください。

セキュリティの設定

アプリケーション構成ファイルでは、セキュリティ プロパティは securityProperties 要素で定義します。これは、dataCacheClient 要素の子です。プログラムからセキュリティ プロパティを構成するには、DataCacheFactoryConfiguration クラスのインスタンスを使用し、このインスタンスを DataCacheFactory クラス コンストラクターのコンストラクターに渡します。詳細については、「構成メソッド (Windows Server AppFabric キャッシュ)」を参照してください。

トランスポートの設定

アプリケーション構成ファイルでは、トランスポート プロパティは transportProperties 要素で定義します。これは、dataCacheClient 要素の子です。プログラムからトランスポート プロパティを構成するには、DataCacheFactoryConfiguration クラスのインスタンスを使用し、このインスタンスを DataCacheFactory クラス コンストラクターのコンストラクターに渡します。詳細については、「構成メソッド (Windows Server AppFabric キャッシュ)」を参照してください。

アプリケーション構成ファイル例

AppFabric アセンブリでアプリケーション構成ファイルの XML 要素を読み取るには、ファイルの最初の要素として、configuration タグの下に configSections 要素を含める必要があります。configSections 要素の中には、dataCacheClient 要素に関連付けられた 1 つの section 要素を含める必要があります。

次の例は、このトピックで説明したキャッシュ クライアント構成オプションを多数使用したアプリケーション構成ファイルを示しています。重要な点として、クラスターに接続するために dataCacheClient に必要な要素は hosts だけであることに注意してください。その他すべての子要素には既定値があります。

<?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 requestTimeout="15000" channelOpenTimeout="3000" maxConnectionsToServer="1">
      <localCache isEnabled="true" sync="TimeoutBased" ttlValue="300" objectCount="10000"/>
      <clientNotification pollInterval="300" maxQueueLength="10000"/>
      <hosts>
         <host name="CacheServer1" cachePort="22233"/>
         <host name="CacheServer2" cachePort="22233"/>
      </hosts>
      <securityProperties mode="Transport" protectionLevel="EncryptAndSign" />
      <transportProperties connectionBufferSize="131072" maxBufferPoolSize="268435456" 
                           maxBufferSize="8388608" maxOutputDelay="2" channelInitializationTimeout="60000" 
                           receiveTimeout="600000"/>
   </dataCacheClient>
</configuration>

関連項目

概念

クライアント構成オプション (Windows Server AppFabric キャッシュ)
クラスターの構成設定 (Windows Server AppFabric キャッシング)
Windows Server AppFabric キャッシュのトラブルシューティング
Windows PowerShell を使用した Windows Server AppFabric キャッシュ機能の管理
Windows Server AppFabric のキャッシュの概念
キャッシュ クライアントを開発する (Windows Server AppFabric キャッシュ)

  2011-12-05