18.2. 単一ファイルキャッシュストア

手順18.1 単一ファイルストアの設定

1. キャッシュ名の追加

   キャッシュの名前を指定するため、local-cache 属性の name パラメーターが使用されます。

   <local-cache name="default">

   Copy to Clipboard Toggle word wrap

2. キャッシュごとの統計

   statistics がコンテナーレベルで有効にされている場合は、statistics 属性を false に設定することにより、キャッシュごとに統計を有効または無効にします。

   <local-cache name="default" statistics="true">

   Copy to Clipboard Toggle word wrap

3. file-store 要素の設定

   file-store 要素は、単一ファイルストアの設定情報を指定します。
   file-store 要素の name パラメーターが、ファイルストアの名前を指定するために使用されます。

   <local-cache name="default" statistics="true">
       <file-store name="myFileStore" />

   Copy to Clipboard Toggle word wrap

4. passivation パラメーターの設定

   passivation パラメーターは、キャッシュのエントリーがパッシベートされるか (true) またはキャッシュストアが内容のコピーをメモリーに保持するか (false) を決定します。

   <local-cache name="default" statistics="true">
       <file-store name="myFileStore"
                   passivation="true" />

   Copy to Clipboard Toggle word wrap

5. purge パラメーターの設定

   purge パラメーターは、起動時にキャッスストアがパージされるかどうかを指定します。 このパラメーターの有効な値は true と false です。

   <local-cache name="default" statistics="true">
       <file-store name="myFileStore"
                   passivation="true"
                   purge="true" />

   Copy to Clipboard Toggle word wrap

6. shared パラメーターを設定します。

   shared パラメーターは、複数のキャッシュストアインスタンスがキャッシュストアを共有する場合に使用されます。複数のキャッシュインスタンスが同じ変更内容を複数回書き込まないようにするため、このパラメーターを設定することができます。このパラメーターに有効な値は true と false です。ただし、shared パラメーターは file-store　には推奨されません。

   <local-cache name="default" statistics="true">
       <file-store name="myFileStore"
                   passivation="true"
                   purge="true"
                   shared="false" />

   Copy to Clipboard Toggle word wrap

7. relative-to パラメーター内のディレクトリーパスを指定します。

   relative-to プロパティーは、file-store がデータを保存するディレクトリーです。これは名前付きのパスを定義するために使用されます。
   path プロパティーは、データが保存されるファイルの名前です。これは、完全パスを決定するために relative-to プロパティーの値に追加される相対パス名です。

   <local-cache name="default" statistics="true">
       <file-store name="myFileStore"
                   passivation="true"
                   purge="true"
                   shared="false"
                   relative-to="{PATH}"
                   path="{DIRECTORY}" />
   </local-cache>

   Copy to Clipboard Toggle word wrap

8. 最大エントリー数の設定

   maxEntries パラメーターは、許可されるエントリーの最大数を指定します。無制限のエントリーの場合のデフォルト値は -1 です。

   <local-cache name="default" statistics="true">
       <file-store name="myFileStore"
                   passivation="true"
                   purge="true"
                   shared="false"
                   relative-to="{PATH}"
                   path="{DIRECTORY}"
                   max-entries="10000"/>
   </local-cache>

   Copy to Clipboard Toggle word wrap

9. fetch-state パラメーターの設定

   fetch-state パラメーターは、true に設定されている場合に、クラスターへ参加する際に永続状態を取り込みます。複数のキャッシュストアがチェーン化されている場合、その内の 1 つのみでこのプロパティーを有効にできます。共有キャッシュストアが使用されている場合、永続状態の転送は、データを提供する同じ永続ストアがそれを受信するだけなので意味をなしません。そのため、共有キャッシュストアが使用されている場合、キャッシュストアがこのプロパティーを true に設定している場合であっても、永続状態の転送を許可しません。クラスター化環境でのみこのプロパティーを true に設定することが推奨されます。このパラメーターのデフォルト値は false です。

   <local-cache name="default" statistics="true">
       <file-store name="myFileStore"
                   passivation="true"
                   purge="true"
                   shared="false"
                   relative-to="{PATH}"
                   path="{DIRECTORY}"
                   max-entries="10000"
                   fetch-state="true"/>
   </local-cache>

   Copy to Clipboard Toggle word wrap

10. Preload パラメーターの設定

    preload パラメーターは、true に設定されている場合に、キャッシュの起動時にキャッシュストアに保存されたデータをメモリーにロードします。ただし、このパラメーターを true に設定することにより、起動時間が増加するためパフォーマンスへの影響があります。このパラメーターのデフォルト値は false です。

    <local-cache name="default" statistics="true">
        <file-store name="myFileStore"
                    passivation="true"
                    purge="true"
                    shared="false"
                    relative-to="{PATH}"
                    path="{DIRECTORY}"
                    max-entries="10000"
                    fetch-state="true"
                    preload="false"/>
    </local-cache>

    Copy to Clipboard Toggle word wrap

11. シングルトンパラメーターの設定

    singleton パラメーターは、シングルトンストアのキャッシュストアを有効にします。SingletonStore は、クラスター内の唯一のインスタンスが基礎となるストアと通信する場合にのみ使用される委譲するキャッシュストアです。ただし、singleton パラメーターは file-store には推奨されません。

    <local-cache name="default" statistics="true">
        <file-store name="myFileStore"
                    passivation="true"
                    purge="true"
                    shared="false"
                    relative-to="{PATH}"
                    path="{DIRECTORY}"
                    max-entries="10000"
                    fetch-state="true"
                    preload="false"
                    singleton="true"/>
    </local-cache>

    Copy to Clipboard Toggle word wrap

手順18.2 ライブラリーモードでの単一ファイルストアの設定

1. 名前の値を namedCache 要素に追加します。以下はこの手順の例になります。

   <namedCache name="writeThroughToFile">

   Copy to Clipboard Toggle word wrap
2. persistence 要素で、passivation パラメーターを false に設定します。使用できる値は「true」と「false」です。

   <namedCache name="writeThroughToFile">
         <persistence passivation="false" />

   Copy to Clipboard Toggle word wrap
3. singleFile 要素を使用して、単一ファイルの設定をセットアップします。
   • fetchPersistentState - true に設定されると、クラスターへ参加する時に永続状態が取り込まれます。複数のキャッシュストアがチェーンされている場合、1 つのキャッシュストアのみがこのプロパティーを true に設定できます。この値のデフォルトは false です。
   • ignoreModifications パラメーターは、キャッシュを変更する操作 (例: 配置、削除、消去、格納など) がキャッシュストアに影響を与えるかどうかを決定します。結果として、キャッシュストアは、キャッシュと同期が取れなくなります。
   • purgeOnStartup パラメーターは、初回起動時にキャッシュがパージされるかどうかを指定します。
   • shared パラメーターは、複数のキャッシュインスタンスがキャッシュストアを共有する場合に true に設定されます。これにより、複数のキャッシュインスタンスが同じ変更内容を個別に書き込むことを防ぐことができます。この属性のデフォルトは false です。ただし、shared パラメーターは file-store には推奨されません。
   • preload パラメーターは、キャッシュストアデータがメモリーにプリロードされ、起動後すぐにアクセス可能にするかどうかを設定します。これを true に設定する不利な点には、起動時間が増えることが挙げられます。この属性のデフォルト値は false です。
   • location パラメーターはファイルストアの場所を示します。
   • maxEntries パラメーターは、許可されるエントリーの最大数を指定します。無制限のエントリーの場合のデフォルト値は -1 です。
   • maxKeysInMemory パラメーターは、データのルックアップを迅速化を図るために使用されます。単一ファイルストアは、maxKeysInMemory パラメーターを使用して、キーのインデックスとファイル内のキーの場所を保持します。このパラメーターのデフォルト値は -1 です。

   <namedCache name="writeThroughToFile">
         <persistence passivation="false">
            <singleFile fetchPersistentState="true" 
                        ignoreModifications="false"
                        purgeOnStartup="false" 
                        shared="false"
                        preload="false"
                        location="/tmp/Another-FileCacheStore-Location"
                        maxEntries="100"
                        maxKeysInMemory="100">
            </singleFile>
         </persistence>
    </namedCache>

   Copy to Clipboard Toggle word wrap
4. 非同期設定を行うには async 要素を追加します。
   • enabled パラメーターは、ファイルストアを非同期にするかどうかを決定します。
   • threadPoolSize パラメーターは、変更をストアに同時に適用するスレッドの数を指定します。このパラメーターのデフォルト値は 5 です。
   • flushLockTimeout パラメーターは、キャッシュストアに定期的にフラッシュする状態を保護するロックを取得するための時間を指定します。このパラメーターのデフォルト値は 1 です。
   • modificationQueueSize パラメーターは、非同期ストアの変更キューのサイズを指定します。基礎となるキャッシュストアがこのキューを処理するよりも速く更新される場合に、その期間において非同期ストアは同期ストアのように動作し、キューがさらに多くの要素を許可できるようになるまでブロックします。このパラメーターのデフォルト値は 1024 要素です。
   • shutdownTimeout パラメーターは、キャッシュストアを停止する時間を指定します。このパラメーターのデフォルト値は 25 秒です。

   <namedCache name="writeThroughToFile">
         <persistence passivation="false">
            <singleFile fetchPersistentState="true" 
                        ignoreModifications="false"
                        purgeOnStartup="false" 
                        shared="false"
                        preload="false"
                        location="/tmp/Another-FileCacheStore-Location"
                        maxEntries="100"
                        maxKeysInMemory="100">
               <async enabled="true" 
       	           threadPoolSize="500"
       	           flushLockTimeout="1"
   	           modificationQueueSize="1024"
   	           shutdownTimeout="25000"/>
           </singleFile>
         </persistence>
    </namedCache>

   Copy to Clipboard Toggle word wrap