nablarch.common.handler

Class DbConnectionManagementHandler

java.lang.Object

nablarch.common.handler.DbConnectionManagementHandler

All Implemented Interfaces:

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>
 

Constructor Summary

Constructors

Constructor and Description
DbConnectionManagementHandler()

Method Summary

Modifier and Type	Method and Description
void	after() 復路処理を行う。
void	before() 往路処理を行う。 ConnectionFactoryからTransactionManagerConnectionを取得し、 DbConnectionContextに設定する。
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) データベース接続のスレッドコンテキスト上の登録名を設定する。

Methods inherited from class java.lang.Object

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

Constructor Detail

DbConnectionManagementHandler

public DbConnectionManagementHandler()

Method Detail

setConnectionFactory

public DbConnectionManagementHandler setConnectionFactory(ConnectionFactory connectionFactory)

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

Parameters:

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

Returns:

このハンドラ自体

setConnectionName

public void setConnectionName(java.lang.String connectionName)

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

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

Parameters:

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

handle

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

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

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

Specified by:

handle in interface Handler<java.lang.Object,java.lang.Object>

Parameters:

inputData - 入力データ

ctx - 実行コンテキスト

Returns:

処理結果データ

before

public void before()

往路処理を行う。

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

after

public void after()

復路処理を行う。

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

handleInbound

public Result handleInbound(ExecutionContext context)

Description copied from interface: InboundHandleable

前処理を実装する。

Specified by:

handleInbound in interface InboundHandleable

Parameters:

context - ExecutionContext

Returns:

処理結果オブジェクト

handleOutbound

public Result handleOutbound(ExecutionContext context)

Description copied from interface: OutboundHandleable

後処理を実装する。

Specified by:

handleOutbound in interface OutboundHandleable

Parameters:

context - ExecutionContext

Returns:

処理結果オブジェクト