SessionIdGenerator コンポーネント

目次

はじめに

SessionIdGenerator 要素は、ウェブアプリケーション HTTP セッションによって使用されるセッション ID を作成するために使用される セッション ID ジェネレーター を表します。

SessionIdGenerator 要素は Manager コンポーネント内にネストできます。含まれていない場合は、デフォルトの SessionIdGenerator 設定が自動的に作成されます。これはほとんどの要件に十分です。この設定の詳細については、以下の 標準 SessionIdGenerator 実装 を参照してください。

属性

共通属性

SessionIdGenerator のすべての実装は、次の属性をサポートします。

属性説明
className

使用する実装の Java クラス名。このクラスは org.apache.catalina.SessionIdGenerator インターフェイスを実装する必要があります。指定されていない場合は、標準値 (以下で定義) が使用されます。

jvmRoute

この Tomcat インスタンスのルーティング識別子。ロードバランサーによるステートレススティッキールーティングを可能にするために、セッション ID に追加されます。jvmRoute がどのように ID に含まれるかについての詳細は、実装によって異なります。標準実装 の既定の動作を参照してください。

注意 - このプロパティの値は Engine 要素の jvmRoute 属性から自動的に継承されます。

sessionIdLength

この SessionIdGenerator が作成するセッション ID の長さ。sessionIdLength がセッション ID の長さにどのように影響するかの詳細は、実装によって異なります。標準実装 の既定の動作を参照してください。

標準実装

Tomcat は、使用する SessionIdGenerator の標準実装を提供します。

標準の SessionIdGenerator 実装

SessionIdGenerator の標準実装は org.apache.catalina.util.StandardSessionIdGenerator です。次の属性をサポートします。

属性説明
jvmRoute

この Tomcat インスタンスのルーティング識別子。セッション ID の最後に "." で区切られて追加されます。

sessionIdLength

この SessionIdGenerator が作成するセッション ID の長さ。より正確には、セッション ID の長さは sessionIdLength のランダムバイトの 2 倍に、指定された場合の末尾の jvmRoute の長さを加えたものです。2 倍という倍率は、セッション ID が sessionIdLength のランダムバイトを使用して構築され、各バイトが実際の ID 内の 2 つの 16 進文字でエンコードされているためです。既定値は 16 です。