セッション・プールを設定する

セッション・プールには SessionPoolManager クラスからアクセスできます。WebLogic Server では、サーブレット・セッション・プールと呼ばれるセッション・プールを使用します。サーブレット・セッション・プールによって、HTTP サーブレット内で使用できるさまざまな機能を追加することができます。

WebLogic Administration Console を使用してサーブレット・セッション・プールを設定すると、次の情報が config.xml コンフィギュレーション・ファイルに追加されます。

<StartupClass
  ClassName="bea.jolt.pool.servlet.weblogic.PoolManagerStartUp"
  FailureIsFatal="false"
  Name="MyStartup Class"
  Targets="myserver"
/>
<JoltConnectionPool
   ApplicationPassword="tuxedo"
   MaximumPoolSize="5"
   MinimumPoolSize="3"
   Name="MyJolt Connection Pool"
   PrimaryAddresses="//TUXSERVER:6309"
   RecvTimeout="300"
   SecurityContextEnabled="true"
   Targets="myserver"
   UserName="joltuser"
   UserPassword="jolttest"
   UserRole="clt"
/>

WebLogic を起動 (または再起動) すると、PoolManagerStartUp クラスと関連する startupArgs が呼び出されます。初回起動時には、PoolManagerStartUp クラスによって ServletSessionPoolManager オブジェクトが作成されます。このオブジェクトには、config.xml コンフィギュレーション・ファイルで設定された ServletSessionPool が含まれます。

以降の呼び出しでは、同じ ServletSessionPoolManager に別の ServletSessionPool が追加されます。前の例に示すように、セッション・プールごとに一意の仮想名をバインディングしてエントリを追加する必要があります。WebLogic Server は、config.xml ファイルの定義に応じて新しい ServletSessionPool を作成します。

サーブレット・セッション・プールにアクセスする

WebLogic Server の起動時に Jolt セッション・プールを設定するように指定すると、Java アプリケーションまたはサーブレットから Jolt セッション・プールにアクセスして使用することができます。既に説明したとおり、WebLogic Server ではすべての ServletSessionPool オブジェクトが同じ ServletSessionPoolManager によって管理されます。

  ServletSessionPoolManager poolMgr = (ServletSessionPoolManager) 

    SessionPoolManager.poolmanager;

WebLogic Server は、SessionPoolManager から派生した ServletSessionPoolManager クラスを使用します。ServletSessionPoolManager は ServletSessionPool オブジェクトを管理します。このオブジェクトは追加の HTTP サーブレット・メソッドを提供します。

SessionPoolManager は、セッション・プールを管理するためのいくつかのメソッドを提供します。次の例では、SessionPoolManager を使用して、joltpoolname という名前の SessionPool を取得します。

  SessionPool sPool = poolMgr.getSessionPool("joltpoolname");

WebLogic Server はサブクラス ServletSessionPoolManager を使用するので、上の例では、SessionPool の代わりに実際には ServletSessionPool オブジェクトが返されます。

次のコード例に示すように、SessionPool を ServletSessionPool にキャストする必要があります。

  ServletSessionPool ssPool =

    (ServletSessionPool) poolMgr.getSessionPool("joltpoolname");

WebLogic Server が ServletSessionPoolManager を作成して設定するので、大部分の場合はこのメソッドだけを使用しますが、ほかの SessionPoolManager メソッドを使用して、個々のセッション・プールまたはすべてのセッション・プールを、作成、中断、停止、またはシャットダウンすることができます。WebLogic の config.xml コンフィギュレーション・ファイルを使用してセッション・プールを設定および管理して、これらの管理タスクを WebLogic Server で処理することをお勧めします。