JCache を使用した Liberty セッション・パーシスタンスの構成

<library id="jCacheVendorLib">
  <fileset dir="${shared.resource.dir}/hazelcast" includes="hazelcast.jar"/>
</library>

<httpSessionCache libraryRef="jCacheVendorLib"/>

• プロバイダー固有の URI を指定する。 javax.caching.spi.CachingProvider.getCacheManager メソッドへの指定には、JCache プロバイダーが文書化する URI 構文を使用します。 この URI は通常、プロバイダー固有の構成ファイルへのパスです。

  <httpSessionCache libraryRef="jCacheVendorLib" uri="file:${shared.resource.dir}/hazelcast/hazelcast.xml"/>

• プロバイダー固有のプロパティーが存在する場合は、そのプロパティーをキーと値のペアとして、httpSessionCache のネストされたプロパティー・エレメントに指定する。 javax.caching.spi.CachingProvider.getCacheManager メソッドへの指定には、JCache プロバイダーが文書化するプロパティー・キーと値を使用します。

  <httpSessionCache libraryRef="jCacheVendorLib">
    <properties hazelcast.config.location="file:${shared.resource.dir}/hazelcast/hazelcast.xml"/>
  </httpSessionCache>

• プロバイダー固有のシステム・プロパティーを指定します。 システム・プロパティーは、 jvm.options ファイルを使用して Liberty で設定できます。

httpSession エレメントおよび httpSessionCache エレメントについて詳しくは、「 JCache セッション・パーシスタンス」を参照してください。

例えば、Hazelcast を JCache プロバイダーとして使用してセッション・パーシスタンスを構成するには、server.xml を次のように構成します。

<server description="Demonstrates HTTP Session Persistence configuration with JCache">
  <featureManager>
    <feature>sessionCache-1.0</feature>
    <feature>servlet-4.0</feature>
  </featureManager>

  <httpEndpoint id="defaultHttpEndpoint" host="*" httpPort="${httpPort}"/>

  <library id="jCacheVendorLib">
    <fileset dir="${shared.resource.dir}/hazelcast" includes="hazelcast.jar"/>
  </library>

  <httpSessionCache libraryRef="jCacheVendorLib"
                    uri="file:${shared.resource.dir}/hazelcast/hazelcast.xml"/>

  <httpSession cloneId="${cloneId}"/>
  <application location="${shared.app.dir}/test.ear"/>
</server>

HTTP サーバー・プラグインは、応答または要求ヘッダーに挿入されるクローン ID を使用して、要求と要求の間でセッション・アフィニティーを保持します。 通常、クローン ID は変更されませんが、 Liberty では、クローン ID はサーバーの初回始動時に生成され、 --clean オプションを指定してサーバーを始動すると再生成されます。 実動で使用する場合、 クローン ID を手動で割り当てることによって、ID が安定し、要求アフィニティーが確実に保持されます。 クローン ID はサーバーごとに固有でなければならず、英数字で構成されていなければなりません。クローン ID は ステップ 2で指定します。

セキュリティー用など、必要な Hazelcast 構成は、 ${shared.resource.dir}/hazelcast/hazelcast.xml ファイルに指定できます。