ts.query
クラス DefaultQueryTransaction

java.lang.Object
  上位を拡張 ts.query.DefaultQueryTransaction
すべての実装されたインタフェース:
QueryTransaction

public class DefaultQueryTransaction
extends java.lang.Object
implements QueryTransaction

ひとまとまりの処理を表すトランザクション・クラスのインターフェイス。
このクラスのbegin()メソッドの実行からend()メソッドの実行 までを一つのトランザクションとして、その間に実行されたクエリによる各接続先 への更新の確定処理または取消処理をまとめて実行する。

バージョン:
$Id: DefaultQueryTransaction.java,v 1.2 2011-08-03 13:42:07 tayu Exp $
作成者:
佐藤隆之

入れ子のクラスの概要
 
インタフェース ts.query.QueryTransaction から継承された入れ子のクラス/インタフェース
QueryTransaction.Error, QueryTransaction.State
 
コンストラクタの概要
protected DefaultQueryTransaction()
          デフォルト・コンストラクタ。
 
メソッドの概要
 void addConnectionFactory(java.lang.String connId, QueryConnectionFactory factory)
          指定されたIDに対応付けられるコネクションのファクトリ・オブジェクトを 設定する。
 void begin()
          トランザクションの開始処理を実行する。
 void begin(long timeoutMillis)
          タイムアウト時間を指定して、トランザクションの開始処理を実行する。
protected  void changeState(QueryTransaction.State[] froms, QueryTransaction.State to)
          トランザクションの状態を変更する。
protected  void checkState(QueryTransaction.State[] allows)
          現在の状態が、指定された状態に含まれているかどうかを判定する。
 void commit()
          クエリの実行結果の確定処理を実行する。
 void end()
          トランザクションを終了する。
 long getBeginTimeMillis()
          トランザクションの開始時刻を取得する。
 QueryConnection getConnection(java.lang.String connId)
          指定されたIDに対応づけられたコネクション・オブジェクトを取得する。
 long getLimitTimeMillis()
          トランザクションのタイムアウトのリミット時刻を取得する。
 QueryTransaction.State getState()
          トランザクションの状態を取得する。
protected  long getTimeoutMillis()
          デフォルトのトランザクション・タイムアウト値を取得する。
 void rollback()
          クエリの実行でエラーが発生した場合に、トランザクション内のクエリ実行結果 を取り消す処理を実行する。
 void setTimeoutMillis(long timeout)
          デフォルトのトランザクション・タイムアウト値を設定する。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

DefaultQueryTransaction

protected DefaultQueryTransaction()
デフォルト・コンストラクタ。

メソッドの詳細

begin

public void begin()
トランザクションの開始処理を実行する。
トランザクションのタイムアウト時間は、このオブジェクトに設定されている デフォルトのタイムアウト時間を使用する。デフォルトのタイムアウト時間が 負の値をとる場合は、タイムアウト制御は行わない。

定義:
インタフェース QueryTransaction 内の begin

begin

public void begin(long timeoutMillis)
タイムアウト時間を指定して、トランザクションの開始処理を実行する。
このオブジェクトが保持するデフォルトのタイムアウト時間は変更しない。 引数に負値を指定した場合は、タイムアウト時間の指定がないものとする。

定義:
インタフェース QueryTransaction 内の begin
パラメータ:
timeoutMillis - タイムアウト時間[msec]。

commit

public void commit()
クエリの実行結果の確定処理を実行する。

定義:
インタフェース QueryTransaction 内の commit

rollback

public void rollback()
クエリの実行でエラーが発生した場合に、トランザクション内のクエリ実行結果 を取り消す処理を実行する。

定義:
インタフェース QueryTransaction 内の rollback

end

public void end()
トランザクションを終了する。

定義:
インタフェース QueryTransaction 内の end

getTimeoutMillis

protected long getTimeoutMillis()
デフォルトのトランザクション・タイムアウト値を取得する。

戻り値:
デフォルトのトランザクション・タイムアウト値[msec]。

setTimeoutMillis

public void setTimeoutMillis(long timeout)
デフォルトのトランザクション・タイムアウト値を設定する。

パラメータ:
timeout - デフォルトのトランザクション・タイムアウト値[msec]。

getBeginTimeMillis

public long getBeginTimeMillis()
トランザクションの開始時刻を取得する。

定義:
インタフェース QueryTransaction 内の getBeginTimeMillis
戻り値:
トランザクションの開始時刻[msec]。

getLimitTimeMillis

public long getLimitTimeMillis()
トランザクションのタイムアウトのリミット時刻を取得する。

定義:
インタフェース QueryTransaction 内の getLimitTimeMillis
戻り値:
トランザクションのタイムアウトのリミット時刻[msec]。

getState

public QueryTransaction.State getState()
トランザクションの状態を取得する。

定義:
インタフェース QueryTransaction 内の getState
戻り値:
トランザクションの状態。

changeState

protected final void changeState(QueryTransaction.State[] froms,
                                 QueryTransaction.State to)
トランザクションの状態を変更する。
現在の状態が、第一引数に指定された状態に含まれていない場合は、例外をスロー する。

パラメータ:
froms - 許される現在の状態。
to - 変更後の状態。

checkState

protected final void checkState(QueryTransaction.State[] allows)
現在の状態が、指定された状態に含まれているかどうかを判定する。

パラメータ:
allows - 許される現在の状態。

getConnection

public QueryConnection getConnection(java.lang.String connId)
                              throws ts.util.ReasonedException
指定されたIDに対応づけられたコネクション・オブジェクトを取得する。

定義:
インタフェース QueryTransaction 内の getConnection
パラメータ:
connId - 接続先を示すID。
戻り値:
コネクション・オブジェクト。
例外:
ts.util.ReasonedException - コネクション・オブジェクトの作成に失敗した場合。

addConnectionFactory

public void addConnectionFactory(java.lang.String connId,
                                 QueryConnectionFactory factory)
指定されたIDに対応付けられるコネクションのファクトリ・オブジェクトを 設定する。

定義:
インタフェース QueryTransaction 内の addConnectionFactory
パラメータ:
connId - コネクションを識別するためのID。
factory - コネクションのファクトリ・オブジェクト。


Copyright (C) SATOH Takayuki All Rights Reserved.