管理および設定ガイド

手順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 EmbeddedCacheManager defaultCacheManager() {
         Configuration configuration = new ConfigurationBuilder();          
         builder.eviction().strategy(EvictionStrategy.LRU).maxEntries(100).build();
         return new DefaultCacheManager(configuration);
      }
   }

   Copy to Clipboard Toggle word wrap
2. デフォルトのキャッシュマネージャーを挿入します。

   ...
   @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

手順11.1 リモートクライアントサーバーモード用 REST コネクターの設定

1. virtual-server パラメーター

   virtual-server パラメーターは、REST コネクターで使用される仮想サーバーを指定します。このパラメーターのデフォルト値は default-host です。これはオプションパラメーターです。

   <subsystem xmlns="urn:infinispan:server:endpoint:6.0">
      <rest-connector virtual-server="default-host" />
   </subsystem>

   Copy to Clipboard Toggle word wrap

2. cache-container パラメーター

   cache-container パラメーターは、REST コネクターで使用されるキャッシュコンテナーを指定します。これは必須パラメーターです。

   <subsystem xmlns="urn:infinispan:server:endpoint:6.0">
      <rest-connector virtual-server="default-host"
                    cache-container="local" />
   </subsystem>

   Copy to Clipboard Toggle word wrap

3. context-path パラメーター

   context-path パラメーターは、REST コネクターのコンテキストパスを指定します。このパラメーターのデフォルト値は空の文字列 ("") です。これはオプションパラメーターです。

   <subsystem xmlns="urn:infinispan:server:endpoint:6.0">
      <rest-connector virtual-server="default-host"
                    cache-container="local"
                    context-path="${CONTEXT_PATH}" />
   </subsystem>

   Copy to Clipboard Toggle word wrap

4. security-domain パラメーター

   security-domain パラメーターは、REST エンドポイントへのアクセスを認証するためにセキュリティーサブシステムで宣言された指定済みドメインを使用することを指定します。これはオプションパラメーターです。このパラメーターが省略されると、認証は実行されません。

   <subsystem xmlns="urn:infinispan:server:endpoint:6.0">
      <rest-connector virtual-server="default-host"
                    cache-container="local"
                    context-path="${CONTEXT_PATH}"
                    security-domain="${SECURITY_DOMAIN}" />
   </subsystem>

   Copy to Clipboard Toggle word wrap

5. auth-method パラメーター

   auth-method パラメーターは、エンドポイントのクレデンシャルを取得するために使用するメソッドを指定します。このパラメーターのデフォルト値は BASIC です。サポートされる別の値には BASIC、DIGEST、および CLIENT-CERT があります。これはオプションパラメーターです。

   <subsystem xmlns="urn:infinispan:server:endpoint:6.0">
      <rest-connector virtual-server="default-host"
                    cache-container="local"
                    context-path="${CONTEXT_PATH}"
                    security-domain="${SECURITY_DOMAIN}"
                    auth-method="${METHOD}"  />
   </subsystem>

   Copy to Clipboard Toggle word wrap

6. security-mode パラメーター

   security-mode パラメーターは、書き込み操作 (PUT、POST、DELETE など) または読み取り操作 (GET や HEAD など) に対してのみ認証が必要かどうかを指定します。このパラメーターの有効な値は WRITE (書き込み操作のみを認証する場合) または READ_WRITE (読み書き操作を認証する場合) です。このパラメーターのデフォルト値は READ_WRITE です。

   <subsystem xmlns="urn:infinispan:server:endpoint:6.0">
      <rest-connector virtual-server="default-host"
                    cache-container="local"
                    context-path="${CONTEXT_PATH}"
                    security-domain="${SECURITY_DOMAIN}"
                    auth-method="${METHOD}" 
                    security-mode="${MODE}" /> 
   </subsystem>

   Copy to Clipboard Toggle word wrap

手順11.2 REST エンドポイントのセキュリティーの有効化

1. セキュリティーパラメーターの指定

   rest エンドポイントで security-domain パラメーターおよび auth-method パラメーターの有効な値を指定するようにします。これらのパラメーターの推奨設定は以下のとおりです。

   <subsystem xmlns="urn:infinispan:server:endpoint:6.0">
               <rest-connector virtual-server="default-host" 
                               cache-container="local" 
                               security-domain="other" 
                               auth-method="BASIC"/>
   </subsystem>

   Copy to Clipboard Toggle word wrap

2. セキュリティードメイン宣言のチェック

   セキュリティーサブシステムに、対応するセキュリティードメイン宣言が含まれるようにします。セキュリティードメイン宣言の設定の詳細については、JBoss Enterprise Application Platform 6 ドキュメンテーションを参照してください。

3. アプリケーションユーザーの追加

   該当するスクリプトを実行し、アプリケーションユーザーを追加する設定を入力します。
   1. adduser.sh スクリプト ($JDG_HOME/bin に存在) を実行します。
      • Windows システムでは、adduser.bat ファイル ($JDG_HOME/bin に存在) を代わりに実行します。
   2. 追加するユーザーのタイプについて尋ねられたら、b を入力して Application User (application-users.properties) を選択します。
   3. リターンキーを押して、レルム (ApplicationRealm) のデフォルト値を使用します。
   4. ユーザー名とパスワードを指定します。
   5. 作成されたユーザーのロールを尋ねられたら、REST と入力します。
   6. プロンプトが表示されたら、ユーザー名とアプリケーションレルム情報が正しいことを確認し、"yes" と入力して作業を続行します。

4. 作成されたアプリケーションユーザーの確認

   作成されたアプリケーションユーザーが正しく設定されていることを確認します。
   1. application-users.properties ファイル ($JDG_HOME/standalone/configuration/ に存在) にリストされた設定を確認します。以下は、このファイルの正しい設定の例です。

      user1=2dc3eacfed8cf95a4a31159167b936fc

      Copy to Clipboard Toggle word wrap
   2. application-roles.properties ファイル ($JDG_HOME/standalone/configuration/ に存在) にリストされた設定を確認します。以下は、このファイルの正しい設定の例です。

      user1=REST

      Copy to Clipboard Toggle word wrap

5. サーバーのテスト

   サーバーを起動し、ブラウザーウィンドウに以下のリンクを入力して REST エンドポイントにアクセスします。

   http://localhost:8080/rest/namedCache

   Copy to Clipboard Toggle word wrap

   注記

   GET 要求の使用をテストする場合は、405 応答コードが期待され、サーバーが正常に認証されたことが示されます。