Woolpack API

woolpack.sql.tx
クラス TxBuilder

java.lang.Object
  上位を拡張 woolpack.sql.tx.TxBuilder

public class TxBuilder
extends java.lang.Object

トランザクションを制御するDataSourceのプロキシと トランザクションが制御されたDataSourceのプロキシを生成するビルダです。 インタープリタ デザインパターンと組み合わせることにより 業務処理から RDB のトランザクション処理を分離することができます。 トランザクションを制御するプロキシから取得したコネクションで管理されたブロック内では、 トランザクションが制御されたプロキシから取得したコネクションが同一スレッド内で共有されます。 このクラスでは DataSource.getConnection()をサポートしますが DataSource.getConnection(String, String)はサポートしません。 このクラスはThreadLocalを使用しています。 このクラスのメソッドは最初に発生した例外を再スローするため、メソッド内で続けて発生した例外の情報は失われます。
適用しているデザインパターン:Thread specific Storage, Proxy, Builder。

作成者:
nakamura

コンストラクタの概要
TxBuilder(javax.sql.DataSource dataSource)
           
 
メソッドの概要
 javax.sql.DataSource getDataSource()
           
 javax.sql.DataSource getTmpDataSource()
          DataSource.getConnection()実行時に以前のリソースを閉じます。
 javax.sql.DataSource getTmpDataSource(boolean refreshFlag)
          トランザクションが制御されたDataSourceのプロキシを返します。
 javax.sql.DataSource getTxDataSource()
          Connection.close()ではコミット・ロールバックのいずれのフラグも立っていない時にコミットします。
 javax.sql.DataSource getTxDataSource(boolean defaultCommitFlag)
          トランザクションを制御するDataSourceのプロキシを返します。
 void setDataSource(javax.sql.DataSource dataSource)
           
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

TxBuilder

public TxBuilder(javax.sql.DataSource dataSource)
パラメータ:
dataSource - RDBに接続するデータソース。
メソッドの詳細

getDataSource

public javax.sql.DataSource getDataSource()

setDataSource

public void setDataSource(javax.sql.DataSource dataSource)

getTxDataSource

public javax.sql.DataSource getTxDataSource()
Connection.close()ではコミット・ロールバックのいずれのフラグも立っていない時にコミットします。

戻り値:
トランザクションを管理するためのDataSource
関連項目:
getTxDataSource(boolean)

getTxDataSource

public javax.sql.DataSource getTxDataSource(boolean defaultCommitFlag)
トランザクションを制御するDataSourceのプロキシを返します。 Connection.rollback()ではロールバックのフラグを立てます。 Connection.commit()ではコミットのフラグを立てます。 Connection.close()では getTmpDataSource(boolean)で作成して開いたままのリソースを全て閉じ、 ロールバックのフラグによってコミットまたはロールバックを実行し、 最後に実際のコネクションを閉じます。

パラメータ:
defaultCommitFlag - Connection.close()でコミット・ロールバックのいずれのフラグも立っていない時にコミットするならtrue。
戻り値:
トランザクションを管理するためのDataSource

getTmpDataSource

public javax.sql.DataSource getTmpDataSource()
DataSource.getConnection()実行時に以前のリソースを閉じます。

戻り値:
トランザクションが管理されたDataSource
関連項目:
getTmpDataSource(boolean)

getTmpDataSource

public javax.sql.DataSource getTmpDataSource(boolean refreshFlag)
トランザクションが制御されたDataSourceのプロキシを返します。 DataSource.getConnection()では ロールバックのフラグが立っている場合はSQLExceptionを投げ、 初めての呼び出しで実際のコネクションを作成し、 引数が true の場合は以前のリソースを閉じます。

パラメータ:
refreshFlag - DataSource.getConnection()実行時に以前のリソースを閉じる場合は true。
戻り値:
トランザクションが管理されたDataSource

Woolpack API

Copyright (C) 2006-2007 Takahiro Nakamura. All rights reserved.