ts.query
クラス DefaultQueryTransaction

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

public class DefaultQueryTransaction
extends java.lang.Object
implements QueryTransaction

ひとまとまりの処理を表すトランザクション・クラス。

バージョン:
$Id: DefaultQueryTransaction.java,v 1.5 2011-09-18 15:59:37 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()
          トランザクションのタイムアウトのリミット時刻を取得する。
 QueryResultList getQueryResultList()
          このトランザクションの中で実行されたクエリの実行結果を格納するQueryResultListオブジェクトを取得する。
 QueryTransaction.State getState()
          トランザクションの状態を取得する。
protected  long getTimeoutMillis()
          デフォルトのトランザクション・タイムアウト値を取得する。
protected  QueryResultList newQueryResultList()
          このトランザクションの中で実行されたクエリ実行結果を格納するリストを作成 する。
 void rollback()
          トランザクション内のクエリの実行結果の取消処理を実行する。
 void setTimeoutMillis(long millis)
          デフォルトのトランザクション・タイムアウト値を設定する。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

DefaultQueryTransaction

protected DefaultQueryTransaction()
デフォルト・コンストラクタ。
このクラスのインスタンスはQueryTransactionManagerクラスによって 生成されることを意図しているため、アクセス指定子をprotectedに している。

メソッドの詳細

newQueryResultList

protected QueryResultList newQueryResultList()
このトランザクションの中で実行されたクエリ実行結果を格納するリストを作成 する。

戻り値:
このトランザクションの中で実行されたクエリ実行結果のリスト。

begin

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

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

begin

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

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

commit

public void commit()
トランザクション内のクエリの実行結果の確定処理を実行する。

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

rollback

public void rollback()
トランザクション内のクエリの実行結果の取消処理を実行する。

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

end

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

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

getState

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

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

getTimeoutMillis

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

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

setTimeoutMillis

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

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

getBeginTimeMillis

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

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

getLimitTimeMillis

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

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

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 - コネクションのファクトリ・オブジェクト。

getQueryResultList

public QueryResultList getQueryResultList()
このトランザクションの中で実行されたクエリの実行結果を格納するQueryResultListオブジェクトを取得する。

定義:
インタフェース QueryTransaction 内の getQueryResultList
戻り値:
QueryResultListオブジェクト。


Copyright (C) SATOH Takayuki All Rights Reserved.