管理および設定ガイド

手順2.1 新しい組み込みキャッシュマネージャーの作成

1. 設定 XML ファイルを作成します。クラスパス上 (たとえば resources/ 内) に my-config.file.xml ファイルを作成します。このファイルに設定情報を追加します。
2. 設定ファイルを使用してキャッシュマネージャーを作成するには、以下のプログラムを使用した設定を使用します。

   EmbeddedCacheManager manager = new DefaultCacheManager("my-config-file.xml");
   Cache defaultCache = manager.getCache();
   

   Copy to Clipboard Toggle word wrap

手順2.2 CDI を使用した新規 EmbeddedCacheManager の作成

1. 次のようにデフォルト設定を指定します。

   public class Config {
       @Produces
       public Configuration defaultEmbeddedConfiguration () {
           return new ConfigurationBuilder()
                            .eviction()
                                    .strategy(EvictionStrategy.LRU)
                                    .maxEntries(100)
                            .build();
       }
   }
   

   Copy to Clipboard Toggle word wrap
2. クラスター化されたキャッシュまたはクラスター化されていないキャッシュを作成します。
3. EmbeddedCacheManager を作成するためのメソッドを呼び出します。

   ...
   @Inject
   EmbeddedCacheManager cacheManager;
   ...
   

   Copy to Clipboard Toggle word wrap

手順3.1 エビクションの初期化

1. エンビクションタグの追加

   <eviction> タグを次のようにプロジェクトの <cache> タグに追加します。

   <eviction />
   

   Copy to Clipboard Toggle word wrap

2. エビクションストラテジーの設定

   使用するエビクションストラテジーを設定するために strategy の値を設定します。使用可能な値は、LRU、UNORDERED および LIRS (またはエビクションが不要な場合は NONE) です。以下は、このステップのサンプルです。

   <eviction strategy="LRU" />
   

   Copy to Clipboard Toggle word wrap

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

   メモリー内で許可されるエントリーの最大数を設定します。無制限のエントリーを許可するためのデフォルト値は -1 です。
   1. ライブラリーモードで、maxEntries パラメーターを次のように設定します。

      <eviction strategy="LRU" maxEntries="200" />
      

      Copy to Clipboard Toggle word wrap
   2. リモートクライアントモードで、max-entries を次のように設定します。

      <eviction strategy="LRU" max-entries="200" />
      

      Copy to Clipboard Toggle word wrap

手順5.1 ルートロガーの設定

1. level プロパティーを設定します

   level プロパティーは、ルートロガーが記録するログメッセージの最大レベルを設定します。

   <subsystem xmlns="urn:jboss:domain:logging:1.2">
      <root-logger>
         <level name="INFO"/>
   

   Copy to Clipboard Toggle word wrap

2. handlers を一覧表示します

   handlers は、ルートロガーによって使用されるログハンドラーの一覧です。

   <subsystem xmlns="urn:jboss:domain:logging:1.2">
        <root-logger>
           <level name="INFO"/>
           <handlers>
              <handler name="CONSOLE"/>
              <handler name="FILE"/>
           </handlers>
        </root-logger>
     </subsystem>
   

   Copy to Clipboard Toggle word wrap

手順5.2 ログカテゴリーの設定

1. カテゴリーの定義

   ログメッセージがキャプチャーされるログカテゴリーを指定するために、category プロパティーを使用します。
   use-parent-handlers はデフォルトで "true" に設定されています。"true" に設定した場合、このカテゴリーは、割り当てられた他のハンドラーだけでなく、ルートロガーのログハンドラーを使用します。

   <subsystem xmlns="urn:jboss:domain:logging:1.2">
      <logger category="com.company.accounts.rec" use-parent-handlers="true">
   

   Copy to Clipboard Toggle word wrap

2. level プロパティーを設定します

   ログカテゴリーが記録するログメッセージの最大レベルを設定するために、level プロパティーを設定します。

   <subsystem xmlns="urn:jboss:domain:logging:1.2">
      <logger category="com.company.accounts.rec" use-parent-handlers="true">
         <level name="WARN"/>
   

   Copy to Clipboard Toggle word wrap

3. handlers　を一覧表示します

   handlers は、ログハンドラーの一覧です。

   <subsystem xmlns="urn:jboss:domain:logging:1.2">
      <logger category="com.company.accounts.rec" use-parent-handlers="true">
         <level name="WARN"/>
         <handlers>
            <handler name="accounts-rec"/>
         </handlers>
      </logger>
   </subsystem>
   

   Copy to Clipboard Toggle word wrap

手順5.3 コンソールログハンドラーの設定

1. ログハンドラーの ID 情報を追加します。

   name プロパティーは、このログハンドラーの一意の ID を設定します。
   autoflush を "true" に設定すると、ログメッセージは要求直後にハンドラーのターゲットに送信されます。

   <subsystem xmlns="urn:jboss:domain:logging:1.2">
      <console-handler name="CONSOLE" autoflush="true">
   

   Copy to Clipboard Toggle word wrap

2. level プロパティーを設定します

   level プロパティーは、記録されるログメッセージの最大レベルを設定します。

   <subsystem xmlns="urn:jboss:domain:logging:1.2">
      <console-handler name="CONSOLE" autoflush="true">
         <level name="INFO"/>
   

   Copy to Clipboard Toggle word wrap

3. encoding 出力を設定します。

   出力に使用する文字エンコーディングスキームを設定するには、encoding を使用します。

   <subsystem xmlns="urn:jboss:domain:logging:1.2">
      <console-handler name="CONSOLE" autoflush="true">
         <level name="INFO"/>
         <encoding value="UTF-8"/>
   

   Copy to Clipboard Toggle word wrap

4. target 値を定義します。

   target プロパティーは、ログハンドラーの出力先となるシステム出力ストリームを定義します。これはシステムエラーストリームの場合は System.err、標準出力ストリームの場合は System.out とすることができます。

   <subsystem xmlns="urn:jboss:domain:logging:1.2">
      <console-handler name="CONSOLE" autoflush="true">
         <level name="INFO"/>
         <encoding value="UTF-8"/>
         <target value="System.out"/>
   

   Copy to Clipboard Toggle word wrap

5. filter-spec プロパティーを定義します。

   filter-spec プロパティーはフィルターを定義する式の値です。以下の例では、not(match("JBAS.*")) はパターンに一致しないフィルターを定義します。

   <subsystem xmlns="urn:jboss:domain:logging:1.2">
      <console-handler name="CONSOLE" autoflush="true">
         <level name="INFO"/>
         <encoding value="UTF-8"/>
         <target value="System.out"/>
         <filter-spec value="not(match(&quot;JBAS.*&quot;))"/>
   

   Copy to Clipboard Toggle word wrap

6. formatter を指定します。

   このログハンドラーで使用するログフォーマッターの一覧を表示するには、formatter を使用します。

   <subsystem xmlns="urn:jboss:domain:logging:1.2">
      <console-handler name="CONSOLE" autoflush="true">
         <level name="INFO"/>
         <encoding value="UTF-8"/>
         <target value="System.out"/>
         <filter-spec value="not(match(&quot;JBAS.*&quot;))"/>
         <formatter>
            <pattern-formatter pattern="%K{level}%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
         </formatter>
      </console-handler>
   </subsystem>
   

   Copy to Clipboard Toggle word wrap

手順5.4 ファイルログハンドラーの設定

1. ファイルログハンドラーの ID 情報を追加します。

   name プロパティーは、このログハンドラーの一意の ID を設定します。
   autoflush を "true" に設定すると、ログメッセージは要求直後にハンドラーのターゲットに送信されます。

   <file-handler name="accounts-rec-trail" autoflush="true">
   

   Copy to Clipboard Toggle word wrap

2. level プロパティーを設定します

   level プロパティーは、ルートロガーが記録するログメッセージの最大レベルを設定します。

   <file-handler name="accounts-rec-trail" autoflush="true">
       <level name="INFO"/>
   

   Copy to Clipboard Toggle word wrap

3. encoding 出力を設定します。

   出力に使用する文字エンコーディングスキームを設定するには、encoding を使用します。

   <file-handler name="accounts-rec-trail" autoflush="true">
       <level name="INFO"/>
       <encoding value="UTF-8"/>
   

   Copy to Clipboard Toggle word wrap

4. file オブジェクトを設定します。

   file オブジェクトは、このログハンドラーの出力が書き込まれるファイルを表します。relative-to と path の 2 つの設定プロパティーが含まれます。
   relative-to プロパティーは、ログファイルが書き込まれるディレクトリーです。JBoss Enterprise Application Platform 6 のファイルパス変数をここで指定できます。jboss.server.log.dir 変数はサーバーの log/ ディレクトリーを指します。
   path プロパティーは、ログメッセージが書き込まれるファイルの名前です。これは、完全パスを決定するために relative-to プロパティーの値に追加される相対パス名です。

   <file-handler name="accounts-rec-trail" autoflush="true">
       <level name="INFO"/>
       <encoding value="UTF-8"/>
       <file relative-to="jboss.server.log.dir" path="accounts-rec-trail.log"/>
   

   Copy to Clipboard Toggle word wrap

5. formatter を指定します。

   このログハンドラーで使用するログフォーマッターの一覧を表示するには、formatter を使用します。

   <file-handler name="accounts-rec-trail" autoflush="true">
       <level name="INFO"/>
       <encoding value="UTF-8"/>
       <file relative-to="jboss.server.log.dir" path="accounts-rec-trail.log"/>
       <formatter>
           <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
       </formatter>
   

   Copy to Clipboard Toggle word wrap

6. append プロパティーを設定します。

   append プロパティーを "true" に設定した場合、このハンドラーが書き込んだすべてのメッセージが既存のファイルに追加されます。"false" に設定した場合、アプリケーションサーバーが起動するたびに新規ファイルが作成されます。append への変更を反映させるには、サーバーの再起動が必要です。

   <file-handler name="accounts-rec-trail" autoflush="true">
       <level name="INFO"/>
       <encoding value="UTF-8"/>
       <file relative-to="jboss.server.log.dir" path="accounts-rec-trail.log"/>
       <formatter>
           <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
       </formatter>
       <append value="true"/>
   </file-handler>
   

   Copy to Clipboard Toggle word wrap

手順5.5 定期ログハンドラーの設定

1. 定期ログハンドラーの ID 情報を追加します。

   name プロパティーは、このログハンドラーの一意の ID を設定します。
   autoflush を "true" に設定すると、ログメッセージは要求直後にハンドラーのターゲットに送信されます。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
   

   Copy to Clipboard Toggle word wrap

2. level プロパティーを設定します

   level プロパティーは、ルートロガーが記録するログメッセージの最大レベルを設定します。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
      <level name="INFO"/>
   

   Copy to Clipboard Toggle word wrap

3. encoding 出力を設定します。

   出力に使用する文字エンコーディングスキームを設定するには、encoding を使用します。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
      <level name="INFO"/>
      <encoding value="UTF-8"/>
   

   Copy to Clipboard Toggle word wrap

4. formatter を指定します。

   このログハンドラーで使用するログフォーマッターの一覧を表示するには、formatter を使用します。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
      <level name="INFO"/>
      <encoding value="UTF-8"/>
      <formatter>
         <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
      </formatter>
   

   Copy to Clipboard Toggle word wrap

5. file オブジェクトを設定します。

   file オブジェクトは、このログハンドラーの出力が書き込まれるファイルを表します。relative-to と path の 2 つの設定プロパティーが含まれます。
   relative-to プロパティーは、ログファイルが書き込まれるディレクトリーです。JBoss Enterprise Application Platform 6 のファイルパス変数をここで指定できます。jboss.server.log.dir 変数はサーバーの log/ ディレクトリーを指します。
   path プロパティーは、ログメッセージが書き込まれるファイルの名前です。これは、完全パスを決定するために relative-to プロパティーの値に追加される相対パス名です。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
      <level name="INFO"/>
      <encoding value="UTF-8"/>
      <formatter>
         <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
      </formatter>
      <file relative-to="jboss.server.log.dir" path="server.log"/>
   

   Copy to Clipboard Toggle word wrap

6. suffix 値を設定します

   suffix は、ローテーションされたログのファイル名に追加され、ローテーションの周期を決定するために使用されます。suffix の形式では、ドット (.) の後に java.text.SimpleDateFormat クラスで解析できる日付文字列が指定されます。ログは suffix で定義された最小時間単位に基づいてローテーションされます。たとえば、yyyy-MM-dd の場合は、ログが日次でローテーションされます。http://docs.oracle.com/javase/6/docs/api/index.html?java/text/SimpleDateFormat.htmlを参照してください。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
      <level name="INFO"/>
      <encoding value="UTF-8"/>
      <formatter>
         <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
      </formatter>
      <file relative-to="jboss.server.log.dir" path="server.log"/>
      <suffix value=".yyyy-MM-dd"/>
   

   Copy to Clipboard Toggle word wrap

7. append プロパティーを設定します。

   append プロパティーを "true" に設定した場合、このハンドラーが書き込んだすべてのメッセージが既存のファイルに追加されます。"false" に設定した場合、アプリケーションサーバーが起動するたびに新規ファイルが作成されます。append への変更を反映させるには、サーバーの再起動が必要です。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
      <level name="INFO"/>
      <encoding value="UTF-8"/>
      <formatter>
         <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
      </formatter>
      <file relative-to="jboss.server.log.dir" path="server.log"/>
      <suffix value=".yyyy-MM-dd"/>
      <append value="true"/>
   </periodic-rotating-file-handler>
   

   Copy to Clipboard Toggle word wrap

手順5.6 サイズログハンドラーの設定

1. サイズログハンドラーの ID 情報を追加します。

   name プロパティーは、このログハンドラーの一意の ID を設定します。
   autoflush を "true" に設定すると、ログメッセージは要求直後にハンドラーのターゲットに送信されます。

   <size-rotating-file-handler name="accounts_debug" autoflush="false">
   

   Copy to Clipboard Toggle word wrap

2. level プロパティーを設定します

   level プロパティーは、ルートロガーが記録するログメッセージの最大レベルを設定します。

   <size-rotating-file-handler name="accounts_debug" autoflush="false">
      <level name="DEBUG"/>
   

   Copy to Clipboard Toggle word wrap

3. encoding 出力を設定します。

   出力に使用する文字エンコーディングスキームを設定するには、encoding を使用します。

   <size-rotating-file-handler name="accounts_debug" autoflush="false">
      <level name="DEBUG"/>
      <encoding value="UTF-8"/>
   

   Copy to Clipboard Toggle word wrap

4. file オブジェクトを設定します。

   file オブジェクトは、このログハンドラーの出力が書き込まれるファイルを表します。relative-to と path の 2 つの設定プロパティーが含まれます。
   relative-to プロパティーは、ログファイルが書き込まれるディレクトリーです。JBoss Enterprise Application Platform 6 のファイルパス変数をここで指定できます。jboss.server.log.dir 変数はサーバーの log/ ディレクトリーを指します。
   path プロパティーは、ログメッセージが書き込まれるファイルの名前です。これは、完全パスを決定するために relative-to プロパティーの値に追加される相対パス名です。

   <size-rotating-file-handler name="accounts_debug" autoflush="false">
      <level name="DEBUG"/>
      <encoding value="UTF-8"/>
      <file relative-to="jboss.server.log.dir" path="accounts-debug.log"/>
   

   Copy to Clipboard Toggle word wrap

5. rotate-size 値を指定します。

   ログファイルがローテーションされる前に到達できる最大サイズです。数字に追加された単一の文字はサイズ単位を示します。バイトの場合は b、キロバイトの場合は k、メガバイトの場合は m、ギガバイトの場合は g になります。たとえば、50 メガバイトの場合は、50m になります。

   <size-rotating-file-handler name="accounts_debug" autoflush="false">
      <level name="DEBUG"/>
      <encoding value="UTF-8"/>
      <file relative-to="jboss.server.log.dir" path="accounts-debug.log"/>
      <rotate-size value="500k"/>
   

   Copy to Clipboard Toggle word wrap

6. max-backup-index 数を設定します。

   保持されるローテーションログの最大数です。この数字に達すると、最も古いログが再利用されます。

   <size-rotating-file-handler name="accounts_debug" autoflush="false">
      <level name="DEBUG"/>
      <encoding value="UTF-8"/>
      <file relative-to="jboss.server.log.dir" path="accounts-debug.log"/>
      <rotate-size value="500k"/>
      <max-backup-index value="5"/>
   

   Copy to Clipboard Toggle word wrap

7. formatter を指定します。

   このログハンドラーで使用するログフォーマッターの一覧を表示するには、formatter を使用します。

   <size-rotating-file-handler name="accounts_debug" autoflush="false">
      <level name="DEBUG"/>
      <encoding value="UTF-8"/>
      <file relative-to="jboss.server.log.dir" path="accounts-debug.log"/>
      <rotate-size value="500k"/>
      <max-backup-index value="5"/>
      <formatter>
           <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
       </formatter>
   

   Copy to Clipboard Toggle word wrap

8. append プロパティーを設定します。

   append プロパティーを "true" に設定した場合、このハンドラーが書き込んだすべてのメッセージが既存のファイルに追加されます。"false" に設定した場合、アプリケーションサーバーが起動するたびに新規ファイルが作成されます。append への変更を反映させるには、サーバーの再起動が必要です。

   <size-rotating-file-handler name="accounts_debug" autoflush="false">
      <level name="DEBUG"/>
      <encoding value="UTF-8"/>
      <file relative-to="jboss.server.log.dir" path="accounts-debug.log"/>
      <rotate-size value="500k"/>
      <max-backup-index value="5"/>
      <formatter>
           <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
       </formatter>
      <append value="true"/>
   </size-rotating-file-handler>
   

   Copy to Clipboard Toggle word wrap

手順5.7 非同期ログハンドラーの設定

1. 非同期ログハンドラーの ID 情報を追加します。

   name プロパティーは、このログハンドラーの一意の ID を設定します。

   <async-handler name="Async_NFS_handlers">
   

   Copy to Clipboard Toggle word wrap

2. level プロパティーを設定します

   level プロパティーは、ルートロガーが記録するログメッセージの最大レベルを設定します。

   <async-handler name="Async_NFS_handlers">
      <level name="INFO"/>
   

   Copy to Clipboard Toggle word wrap

3. queue-length を定義します。

   queue-length は、サブハンドラーの応答を待機する間に、このハンドラーが保持するログメッセージの最大数を定義します。

   <async-handler name="Async_NFS_handlers">
      <level name="INFO"/>
      <queue-length value="512"/>
   

   Copy to Clipboard Toggle word wrap

4. オーバーフロー応答を設定します。

   overflow-action は、キューの長さを超えたときにこのハンドラーがどのように応答するかを定義します。これは BLOCK または DISCARD に設定できます。BLOCK の場合、キューでスペースが利用可能になるまでロギングアプリケーションが待機します。これは、非同期ではないログハンドラーと同じ動作です。DISCARD の場合、ロギングアプリケーションは動作を続けますが、ログメッセージは削除されます。

   <async-handler name="Async_NFS_handlers">
      <level name="INFO"/>
      <queue-length value="512"/>
      <overflow-action value="block"/>
   

   Copy to Clipboard Toggle word wrap

5. subhandlers の一覧を表示します。

   subhandlers リストは、この非同期ハンドラーがログメッセージを渡すログハンドラーの一覧です。

   <async-handler name="Async_NFS_handlers">
      <level name="INFO"/>
      <queue-length value="512"/>
      <overflow-action value="block"/>
      <subhandlers>
         <handler name="FILE"/>
         <handler name="accounts-record"/>
      </subhandlers>
   </async-handler>
   

   Copy to Clipboard Toggle word wrap

手順6.2 local-cache 要素

1. ローカルキャッシュ名の追加

   name パラメーターは使用するローカルキャッシュの名前を指定します。

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

   Copy to Clipboard Toggle word wrap

2. キャッシュコンテナーの開始モードを設定します。

   start パラメーターはキャッシュコンテナーが起動する時を示します (要求時にレイジーに起動するか、またはサーバー起動時に「すぐに (eargerly)」起動するかなど)。このパラメーターの有効な値は EAGER と LAZY です。

   <cache-container name="local"
                     default-cache="default" 
                     statistics="true">
            <local-cache name="default"
                             start="EAGER" >
   

   Copy to Clipboard Toggle word wrap

3. バッチ処理の設定

   batching パラメーターは、ローカルキャッシュに対してバッチ処理が有効であるかを指定します。

   <cache-container name="local"
                     default-cache="default"
                     statistics="true">
            <local-cache name="default"
                             start="EAGER"
                             batching="false" >
   

   Copy to Clipboard Toggle word wrap

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

   statistics がコンテナーレベルで有効にされている場合、statistics 属性を false に設定することにより、キャッシュごとの統計は、モニタリングを必要としないキャッシュについては選択的に無効にすることができます。

   <cache-container name="local"
                     default-cache="default"
                     statistics="true">
            <local-cache name="default"
                             start="EAGER"
                             batching="false"
                             statistics="true">
   

   Copy to Clipboard Toggle word wrap

5. インデックス化のタイプの指定

   indexing パラメーターはローカルキャッシュに使用されるインデックス化のタイプを指定します。このパラメーターの有効な値は NONE、 LOCAL、および ALL です。

   <cache-container name="local"
                     default-cache="default" 
                     statistics="true">
            <local-cache name="default"
                             start="EAGER"
                             batching="false"
                             statistics="true">
                     <indexing index="NONE">
   	                <property name="default.directory_provider">ram</property>
                     </indexing>
            </local-cache>
   

   Copy to Clipboard Toggle word wrap

手順10.3 明示的な悲観的ロックによるトランザクション

1. 行 cache.lock(K) が実行されると、K でクラスター全体のロックが取得されます。

   tx.begin()
   cache.lock(K)
   

   Copy to Clipboard Toggle word wrap
2. 行 cache.put(K,V5) が実行されると、取得の成功が保証されます。

   tx.begin()
   cache.lock(K)           
   cache.put(K,V5)
   

   Copy to Clipboard Toggle word wrap
3. 行 tx.commit() が実行されると、この処理のために保持されたロックが開放されます。

   tx.begin()
   cache.lock(K)           
   cache.put(K,V5)         
   tx.commit()             
   
   

   Copy to Clipboard Toggle word wrap

手順10.4 暗黙的な悲観的ロックによるトランザクション

1. 行 cache.put(K,V) が実行されると、K でクラスター全体のロックが取得されます。

   tx.begin()
   cache.put(K,V)
   

   Copy to Clipboard Toggle word wrap
2. 行 cache.put(K2,V2) が実行されると、K2 でクラスター全体のロックが取得されます。

   tx.begin()
   cache.put(K,V)
   cache.put(K2,V2)
   

   Copy to Clipboard Toggle word wrap
3. 行 cache.put(K,V5) が実行されると、 K のクラスター全体のロックは以前取得されたため、ロックの取得は実行できませんが、put 操作は発生します。

   tx.begin()
   cache.put(K,V)
   cache.put(K2,V2)
   cache.put(K,V5)
   

   Copy to Clipboard Toggle word wrap
4. 行 tx.commit() が実行されると、このトランザクションのために保持されたすべてのロックが開放されます。

   tx.begin()
   cache.put(K,V)
   cache.put(K2,V2)
   cache.put(K,V5)
   tx.commit()
   

   Copy to Clipboard Toggle word wrap

手順13.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