nablarch.common.handler

クラス DbConnectionManagementHandler

java.lang.Object

nablarch.common.handler.DbConnectionManagementHandler

すべての実装されたインタフェース:

Handler<java.lang.Object,java.lang.Object>, InboundHandleable, OutboundHandleable

public class DbConnectionManagementHandler
extends java.lang.Object
implements Handler<java.lang.Object,java.lang.Object>, InboundHandleable, OutboundHandleable

後続ハンドラの処理で必要となる、データベース接続オブジェクトを スレッドローカル変数上で管理するハンドラ。

 デフォルトの設定では、トランザクションが暗黙的に使用する接続名
 (TransactionContext.DEFAULT_TRANSACTION_CONTEXT_KEY)
 に対して接続オブジェクトを登録する。
 接続名を明示的に指定する場合は、属性dbConnectionNameにその値を設定する。

 <!-- 設定例 -->
 <component class="nablarch.common.handler.DbConnectionManagementHandler">
      <!-- DbConnectionFactory -->
      <property name="dbConnectionFactory" ref="dbConnectionFactory"/>
      <!-- 追加するデータベース接続オブジェクトの名称 -->
      <property name="dbConnectionName" value="db"/>
 </component>
 

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
DbConnectionManagementHandler()

メソッドのサマリー

修飾子とタイプ	メソッドと説明
void	after() 復路処理を行う。
void	before() 往路処理を行う。
java.lang.Object	handle(java.lang.Object inputData, ExecutionContext ctx) 入力データに対する処理を実行する。
Result	handleInbound(ExecutionContext context) 前処理を実装する。
Result	handleOutbound(ExecutionContext context) 後処理を実装する。
DbConnectionManagementHandler	setConnectionFactory(ConnectionFactory connectionFactory) データベース接続オブジェクトを生成するためのファクトリを設定する。
void	setConnectionName(java.lang.String connectionName) データベース接続のスレッドコンテキスト上の登録名を設定する。

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

DbConnectionManagementHandler

public DbConnectionManagementHandler()

メソッドの詳細

setConnectionFactory

public DbConnectionManagementHandler setConnectionFactory(ConnectionFactory connectionFactory)

データベース接続オブジェクトを生成するためのファクトリを設定する。

パラメータ:

connectionFactory - データベース接続オブジェクトを生成するためのファクトリ

戻り値:

このハンドラ自体

setConnectionName

public void setConnectionName(java.lang.String connectionName)

データベース接続のスレッドコンテキスト上の登録名を設定する。

 デフォルトでは既定のトランザクション名
 (TransactionContext.DEFAULT_TRANSACTION_CONTEXT_KEY)を使用する。
 

パラメータ:

connectionName - データベース接続のスレッドコンテキスト上の登録名

handle

public java.lang.Object handle(java.lang.Object inputData,
                               ExecutionContext ctx)

入力データに対する処理を実行する。

 このクラスの実装では後続ハンドラに対する処理委譲の前後に、
 データベース接続オブジェクトの初期化と終了の処理をそれぞれ行う。
 

定義:

handle インタフェース内 Handler<java.lang.Object,java.lang.Object>

パラメータ:

inputData - 入力データ

ctx - 実行コンテキスト

戻り値:

処理結果データ

before

public void before()

往路処理を行う。

ConnectionFactoryからTransactionManagerConnectionを取得し、 DbConnectionContextに設定する。

after

public void after()

復路処理を行う。 DbConnectionContextからデータベース接続を削除し、リソースの開放処理を行う。

handleInbound

public Result handleInbound(ExecutionContext context)

インタフェースからコピーされた説明: InboundHandleable

前処理を実装する。

定義:

handleInbound インタフェース内 InboundHandleable

パラメータ:

context - ExecutionContext

戻り値:

処理結果オブジェクト

handleOutbound

public Result handleOutbound(ExecutionContext context)

インタフェースからコピーされた説明: OutboundHandleable

後処理を実装する。

定義:

handleOutbound インタフェース内 OutboundHandleable

パラメータ:

context - ExecutionContext

戻り値:

処理結果オブジェクト