|
coherence-factory-class
|
使用するSessionHelper.Factoryの完全修飾クラス名。
デフォルトでcom.tangosol.coherence.servlet.apiXX.DefaultFactoryに設定されます。ここで、XXは、22、23、24、25のいずれかで、それぞれ、サーブレット2.2、2.3、2.4、2.5コンテナに対応します。
|
|
coherence-sessioncollection-class
|
使用するHttpSessionCollection実装の完全修飾クラス名。使用可能な値は次のとおりです。
このパラメータは、値の指定が必須です。
|
|
coherence-cluster-owned
|
trueの場合は、Webアプリケーションを終了すると自動的にCoherenceノードが終了します。この場合は、WARスコープ設定クラスタ・ノードによるデプロイメント・モデルを使用する必要があります。詳細は、「WARスコープ設定クラスタ・ノード」を参照してください。
falseの場合は、Webアプリケーションの独自の判断でCoherenceノードを終了する必要があります（com.tangosol.net.CacheFactory.shutdown()を参照）。クラスタ・ノードをスコープ設定したデプロイメント・モデルのこの状況での使用、およびアプリケーションがCoherenceノードを終了する環境とその終了処理に伴う副作用を慎重に検討する必要があります。クラスタ・ノードのスコープ設定の詳細は、「クラスタ・ノード分離」を参照してください。
注意: WebInstallerを使用している場合は、trueを指定すると、J2EEアプリケーションにある各WebアプリケーションのWEB-INF/libディレクトリにCoherenceライブラリを配置できます。
値を指定しない場合、このパラメータはデフォルトでfalseに設定されます。
|
|
coherence-servletcontext-clustered（注意1参照）
|
ServletContextの属性をクラスタ化するかどうかを指定するtrueまたはfalse。trueの場合は、シリアライズ可能なすべてのServletContext属性値がすべてのクラスタ・ノード間で共有されます。
値を指定しない場合は、デフォルトでfalseに設定されます。この主な理由は、ServletContext属性はJVMに対してローカルであり、クラスタ化しないことがサーブレット仕様で規定されているためです。
|
|
coherence-servletcontext-cachename（注意1参照）
|
サーブレット・コンテキストをクラスタ化している場合にサーブレットのコンテキスト・データを保持するために使用するCoherenceキャッシュの名前。
値を指定しない場合は、デフォルトでservletcontext-storageに設定されます。このパラメータの詳細は、付録B「セッション・キャッシュ・コンフィギュレーション・ファイル」を参照してください。
|
|
coherence-eventlisteners（注意1参照）
|
Webコンテナからイベントを受信する必要があるアプリケーション・クラス名のカンマ区切りリスト。このリストは、web.xmlのlistener要素で宣言したアプリケーション・リスナーから得られます。
|
|
coherence-enable-sessioncontext（注意1参照）
|
trueに設定した場合は、アプリケーションでセッション・コンテキストのセッションを繰り返すことができます。この処理は、サーブレット仕様では推奨されていません。
値を指定しない場合は、デフォルトでfalseに設定されます。
|
|
coherence-contextless-session-retain-millis
|
現在のリクエスト・コンテキストとは直接の関係がないセッションにアクセスしているときに、そのセッションに対するロックを保持する時間（ミリ秒）。現在のリクエスト・コンテキストからセッションが暗黙的に指定されるのは、現在のスレッドでサーブレット・リクエストが処理されており、そのセッションに関連付けられている場合のみです。セッション・オブジェクトに対するその他のすべてのアクセスは「コンテキスト外」となります。たとえば、任意のセッションへの参照をSessionContextオブジェクトから取得する場合（該当のオプションが有効になっている場合）や、セッションを直接管理するためのセッション・オブジェクト参照を保持するコードがアプリケーションに記述されている場合です。セッションへのアクセスにはそのセッションの所有権が必要なので、セッション・オブジェクトに対する「コンテキスト外」アクセスでは、コール元にかわって自動的に所有権を取得できます。この所有権はこのオプションで指定した時間だけ保持できるので、セッションのコールごとに所有権の取得と解放が繰り返される、時間のかかる操作を省略できます。指定できる時間は10〜10000ミリ秒（1/100〜10秒）です。
値を指定しない場合は、デフォルトで200に設定されます。
|
|
coherence-session-cookies-enabled（注意1参照）
|
値を指定しない場合は、デフォルトでtrueに設定され、セッションのCookieが有効になります。
|
|
coherence-session-cookie-name（注意1参照）
|
セッションCookieの名前。
値を指定しない場合は、デフォルトでJSESSIONIDに設定されます。
|
|
coherence-session-cookie-domain（注意1参照）
|
RFC 2109で定義されているセッションCookieのドメイン。デフォルトでは、セッション管理実装によって明示的に設定されているドメインはありません。
|
|
coherence-session-cookie-path（注意1参照）
|
RFC 2109で定義されているセッションCookieのパス。デフォルトでは、セッション管理実装によって明示的に設定されているパスはありません。
|
|
coherence-session-cookie-max-age（注意1参照）
|
RFC 2109で定義されているセッションCookieの最長有効期間（秒）。-1を指定すると、クライアント上ではCookieが維持されません。正の値を指定すると、最長でその秒数、Cookieがクライアント上で維持されます。0は指定できません。
値を指定しない場合は、デフォルトで-1に設定されます。
|
|
coherence-session-urlencode-enabled（注意1参照）
|
trueに設定した場合は、セッションIDのURLエンコーディングが有効になります。
値を指定しない場合は、デフォルトでtrueに設定されます。
|
|
coherence-session-urlencode-name（注意1参照）
|
URLにエンコードしたセッションIDに使用するパラメータ名。コンテナによっては、この値をオーバーライドできない場合があります。
値を指定しない場合は、デフォルトでjsessionidに設定されます。
|
|
coherence-session-urldecode-bycontainer（注意1参照）
|
trueに設定した場合は、コンテナのURLセッションIDのデコードが使用されます。coherence-session-urlencode-nameがオーバーライドされている場合は、この値をfalseに設定する必要があります。コンテナによっては、この値をfalseに設定しても機能しない場合があります。
値を指定しない場合は、デフォルトでtrueに設定されます。
|
|
coherence-session-urlencode-bycontainer（注意1参照）
|
trueに設定した場合は、コンテナのURLセッションIDのエンコードが使用されます。この値をtrueに設定すると、事前に指定したcoherence-session-urlencode-nameの設定と矛盾する場合があります。
値を指定しない場合は、デフォルトでfalseに設定されます。
|
|
coherence-reaperdaemon-cluster-coordinated
|
trueに設定した場合は、指定したリープ・サイクル中に1台のサーバーのみでリープを実行し、クラスタで管理しているすべてのセッションをそのサーバーで確認するようにクラスタ内のリープが調整されます。セッション・リーパーの詳細は、「期限切れHTTPセッションのクリーンアップ」を参照してください。
値を指定しない場合は、デフォルトでfalseに設定されます。
|
|
coherence-reaperdaemon-sweep-modulo
|
Coherenceリリース3.5以降、このパラメータは廃止されています。
|
|
coherence-reaperdaemon-assume-locality
|
この設定により、リーパーでは、（たとえば、分散キャッシュ・サービスによって）このノードに保存されるセッションは、期限切れをチェックする必要のあるセッションのみであると仮定できます。リーパーを実行していないノードでセッションの記憶域キャッシュを管理している場合は、この値をfalseに設定する必要があります。たとえば、セッションの記憶域キャッシュの管理にキャッシュ・サーバーを使用している場合がこれに該当します（キャッシュ・サーバーを使用している場合は、「スプリット」モデルを選択し、全体をそのキャッシュ・サーバーで管理している独立した分散キャッシュ・サービスでセッションのオーバーフロー記憶域を実行することをお薦めします。この場合、セッションの記憶域キャッシュ自体は、全体をアプリケーション・サーバーJVMで管理している分散キャッシュ・サービスに残します。これによって、この「ローカル性を前提とした」機能を活用できます）。セッション・リーパーの詳細は、「期限切れHTTPセッションのクリーンアップ」を参照してください。
値を指定しない場合は、デフォルトでtrueに設定されます。
|
|
coherence-reaperdaemon-cycle-seconds
|
リープ処理の間でデーモンが待機する秒数。セッション・タイムアウトが長い本番クラスタの場合は大きい値に設定できます。特にセッション・タイムアウトが短いテストの場合は小さい値に設定します。設定値が小さすぎると、ネットワーク・トラフィックの増加や処理に費やすサイクルの増加が発生します。小さい設定値が効果的なのは、期限切れのセッションをアプリケーションで迅速に無効にする必要がある場合のみです。セッション・リーパーの詳細は、「期限切れHTTPセッションのクリーンアップ」を参照してください。
値を指定しない場合は、デフォルトで300に設定されます。
|
|
coherence-reaperdaemon-priority
|
セッションのリーパー・デーモンの優先度。詳細は、java.lang.Threadクラスのソースを参照してください。
値を指定しない場合は、デフォルトで5に設定されます。
|
|
coherence-session-cachename
|
この名前は、セッションを保存するクラスタ・キャッシュの名前をオーバーライドします。
値を指定しない場合は、デフォルトでsession-storageに設定されます。このパラメータの詳細は、付録B「セッション・キャッシュ・コンフィギュレーション・ファイル」を参照してください。
|
|
coherence-session-deathcert-cachename
|
この名前は、「最近期限切れになった」セッションのIDを保存するクラスタ・キャッシュの名前をオーバーライドします。
値を指定しない場合は、デフォルトでsession-death-certificatesに設定されます。このパラメータの詳細は、付録B「セッション・キャッシュ・コンフィギュレーション・ファイル」を参照してください。
|
|
coherence-session-management-cachename
|
この名前は、セッション管理実装の管理情報とコンフィギュレーション情報を保存するクラスタ・キャッシュの名前をオーバーライドします。通常は、レプリケーション・キャッシュとして構成する必要があります。
値を指定しない場合は、デフォルトでsession-managementに設定されます。このパラメータの詳細は、付録B「セッション・キャッシュ・コンフィギュレーション・ファイル」を参照してください。
|
|
coherence-session-expire-seconds
|
この値は、セッションの有効期限をオーバーライドします。単位は秒です。-1に設定した場合は、セッションが無期限になります。
値を指定しない場合は、デフォルトで1880に設定されます。
|
|
coherence-session-id-length（注意1参照）
|
生成されるセッションIDの文字数です。推奨の絶対最小長は8です。
値を指定しない場合は、デフォルトで12に設定されます。
|
|
coherence-shutdown-delay-seconds
|
アプリケーションが停止したという最後の通知をServletContextListenerイベント（サーブレット2.3以降）またはServletオブジェクトとFilterオブジェクトの破棄によって受けてからシャットダウンするまでにセッション管理実装が待機する時間が、この値で決まります。この値は秒単位で表します。0を指定すると同期シャットダウンになり、正の値を指定すると非同期シャットダウンになります。
値を指定しない場合は、デフォルトで0に設定されます。これは、非同期シャットダウン機能のないサーバーが存在するためです。
|
|
coherence-session-member-locking
|
この値をtrueに設定した場合は、別々のJVMにある2つのスレッドで1つの同じセッションに対するリクエストを同時に処理することはできなくなります。falseを指定すると、スティッキー・セッション最適化およびスレッド・ロックとの互換性がなくなります（つまり、この値をfalseに設定する場合は、coherence-session-thread-lockingとcoherence-sticky-sessionsの両方をfalseに設定する必要があります）。
値を指定しない場合は、デフォルトでfalseに設定されます。
|
|
coherence-session-app-locking
|
この値をtrueに設定した場合は、別々のアプリケーションにある2つのスレッドで1つの同じセッションに対するリクエストを同時に処理することはできなくなります。値をfalseに設定すると、スレッド・ロックとの互換性がなくなります。trueに設定した場合、アプリケーション・ロックは暗黙的にメンバー・ロックになるので、coherence-session-member-lockingパラメータの値が無視されます。
値を指定しない場合は、デフォルトでfalseに設定されます。
|
|
coherence-session-thread-locking
|
この値をtrueに設定した場合は、同じJVMにある2つのスレッドで1つの同じセッションに対するリクエストを同時に処理することはできなくなります。trueに設定した場合、スレッド・ロックは暗黙的にメンバー・ロックになるので、coherence-session-member-lockingパラメータの値が無視されます。
値を指定しない場合は、デフォルトでtrueに設定されます。
|
|
coherence-session-strict-spec
|
この値をtrueに設定した場合は、実装はサーブレット仕様に厳密に従います。falseに設定した場合は、特定のタイプの例外が発生しても、実装はアプリケーションをシャットダウンせずにその例外を無視できます。
値を指定しない場合は、デフォルトでtrueに設定されます。
|
|
coherence-sticky-sessions
|
この値をtrueに設定した場合は、スティッキー・セッション最適化が使用されます。この設定は、スティッキー・ロード・バランサを使用している場合にのみ有効にする必要があります。
値を指定しない場合は、デフォルトでfalseに設定されます。
|
|
coherence-distributioncontroller-class
|
この値は、使用するcom.tangosol.coherence.servlet.HttpSessionCollection$SessionDistributionControllerインタフェース実装のクラス名を指定します。この機能では、coherence-sticky-sessions最適化を有効にする必要があります。
使用可能な値は次のとおりです。
|
|
coherence-scopecontroller-class
|
この値は、使用するオプションのcom.tangosol.coherence.servlet.HttpSessionCollection$AttributeScopeControllerインタフェース実装のクラス名を指定します。
詳細は、「セッション属性スコープ設定」を参照してください。
使用可能な値は次のとおりです。
|
|
coherence-preserve-attributes
|
この値をtrueに設定した場合は、シリアライズ不可能な属性をローカルな属性として維持する指定となります。この機能では、coherence-sticky-sessions最適化を有効にする必要があります。
値を指定しない場合は、デフォルトでfalseに設定されます。
|
|
coherence-local-session-cachename
|
この名前は、coherence-distributioncontroller-classパラメータを指定した場合に、分散されないセッションを保存するローカル・キャッシュの名前をオーバーライドします。
値を指定しない場合は、デフォルトでlocal-session-storageに設定されます。このパラメータの詳細は、付録B「セッション・キャッシュ・コンフィギュレーション・ファイル」を参照してください。
|
|
coherence-local-attribute-cachename
|
この名前は、coherence-sessiondistributioncontroller-classパラメータを指定した場合またはcoherence-preserve-attributesパラメータにtrueを指定した場合に、分散されないセッションを保存するローカル・キャッシュの名前をオーバーライドします。
値を指定しない場合は、デフォルトでlocal-attribute-storageに設定されます。このパラメータの詳細は、付録B「セッション・キャッシュ・コンフィギュレーション・ファイル」を参照してください。
|
|
coherence-session-overflow-cachename
|
所定のサイズより大きいことから、シリアライズしたセッション・オブジェクト自体の一部としてではなく、個別のキャッシュ・エントリとしたほうが効率的に管理できると判断される「大型の属性」を保存するクラスタ・キャッシュの名前を、スプリット・モデルの場合にこの値がオーバーライドします。
値を指定しない場合は、デフォルトでsession-overflowに設定されます。このパラメータの詳細は、付録B「セッション・キャッシュ・コンフィギュレーション・ファイル」を参照してください。
|
|
coherence-attribute-overflow-threshold
|
大型の属性向けに確保されている独立した「オーバーフロー」キャッシュに属性値を格納できるようにするために、その属性値のシリアライズした形式で確保する必要がある最小長（バイト数）を、スプリット・モデルの場合にこの値で指定します。
値を指定しない場合は、デフォルトで1024に設定されます。
|
