ts.query
インタフェース IQueryTransaction

既知の実装クラスの一覧:
QueryTransaction

public interface IQueryTransaction

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

バージョン:
$Id: IQueryTransaction.java,v 1.5 2012-01-30 16:41:22 tayu Exp $
作成者:
佐藤隆之

入れ子のクラスの概要
static class IQueryTransaction.Error
          このクラスで発生しうるエラーの列挙型。
static class IQueryTransaction.State
          トランザクションの状態を示す列挙型。
 
メソッドの概要
 void begin()
          トランザクションの開始処理を実行する。
 void commit()
          トランザクション内のクエリの実行結果の確定処理を実行する。
 void end()
          トランザクションを終了する。
 long getBeginTimeMillis()
          トランザクションの開始時刻を取得する。
 long getLimitTimeMillis()
          トランザクションの制限時刻を取得する。
 IQuery getQuery(java.lang.String queryId)
          指定されたクエリIDに対応するクエリ・オブジェクトを取得する。
 IQueryConnection getQueryConnection(java.lang.String connId)
          指定された接続先IDに対応するクエリ・コネクション・オブジェクトを取得する。
 IQueryExecution getQueryExecution(java.lang.String execId)
          指定された実行IDに対応するクエリ実行ブジェクトを取得する。
 IQueryHistory getQueryHistory()
          このトランザクションの中で実行されたクエリの実行履歴を格納するIQueryHistoryオブジェクトを取得する。
 IQueryTransaction.State getState()
          トランザクションの状態を取得する。
 long getTimeoutMillis()
          トランザクションのタイムアウト時間を取得する。
 void rollback()
          トランザクション内のクエリの実行結果の取消処理を実行する。
 void setTimeoutMillis(long millis)
          トランザクションのタイムアウト時間を設定する。
 

メソッドの詳細

begin

void begin()
           throws ts.util.ReasonedException,
                  ts.util.ReasonedRuntimeException
トランザクションの開始処理を実行する。
このメソッドの実行すると、トランザクションの開始時刻が設定され、その開始 時刻とタイムアウト時間を加算して制限時刻が設定される。 制限時間はクエリの実行中のタイムアウト判定に使用される。

例外:
ts.util.ReasonedException - トランザクションの開始処理に失敗した場合。
ts.util.ReasonedRuntimeException - トランザクションの状態が不正な場合。

commit

void commit()
            throws ts.util.ReasonedException,
                   ts.util.ReasonedRuntimeException
トランザクション内のクエリの実行結果の確定処理を実行する。

例外:
ts.util.ReasonedException - トランザクションの確定処理に失敗した場合。
ts.util.ReasonedRuntimeException - トランザクションの状態が不正な場合。

rollback

void rollback()
              throws ts.util.ReasonedRuntimeException
トランザクション内のクエリの実行結果の取消処理を実行する。
途中で例外が発生してもこの処理は続行され、この処理が完了した所で例外が スローされる。

例外:
ts.util.ReasonedRuntimeException - トランザクションの取消処理に失敗した場合、 又はトランザクションの状態が不正な場合。

end

void end()
         throws ts.util.ReasonedRuntimeException
トランザクションを終了する。
トランザクションが確定又は取消されていない場合は、取消を実行してから終了 する。

例外:
ts.util.ReasonedRuntimeException - トランザクションの終了処理に失敗した場合、 又はトランザクションの状態が不正な場合。

getState

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

戻り値:
トランザクションの状態。

getBeginTimeMillis

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

戻り値:
トランザクションの開始時刻 [msec]。

getLimitTimeMillis

long getLimitTimeMillis()
トランザクションの制限時刻を取得する。
値がゼロ以下の場合は制限なしとする。

戻り値:
トランザクションの制限時刻 [msec]。

getTimeoutMillis

long getTimeoutMillis()
トランザクションのタイムアウト時間を取得する。
値がゼロ以下の場合は制限なしとする。

戻り値:
トランザクションのタイムアウト時間 [msec]。

setTimeoutMillis

void setTimeoutMillis(long millis)
トランザクションのタイムアウト時間を設定する。
引数の値がゼロ以下の場合は制限なしとする。

パラメータ:
millis - トランザクションのタイムアウト時間 [msec]。

getQueryHistory

IQueryHistory getQueryHistory()
このトランザクションの中で実行されたクエリの実行履歴を格納するIQueryHistoryオブジェクトを取得する。

戻り値:
IQueryHistoryオブジェクト。

getQueryConnection

IQueryConnection getQueryConnection(java.lang.String connId)
                                    throws ts.util.ReasonedException,
                                           ts.util.ReasonedRuntimeException
指定された接続先IDに対応するクエリ・コネクション・オブジェクトを取得する。

パラメータ:
connId - 接続先ID。
戻り値:
コネクション・オブジェクト。
例外:
ts.util.ReasonedException - コネクションの開始処理に失敗した場合。
ts.util.ReasonedRuntimeException - コネクション・オブジェクトの作成に失敗 した場合、又はトランザクションの状態が不正な場合。

getQueryExecution

IQueryExecution getQueryExecution(java.lang.String execId)
                                  throws ts.util.ReasonedException,
                                         ts.util.ReasonedRuntimeException
指定された実行IDに対応するクエリ実行ブジェクトを取得する。

パラメータ:
execId - 実行ID。
戻り値:
クエリ実行オブジェクト。
例外:
ts.util.ReasonedException - クエリが使用するコネクションの開始処理に失敗した 場合。
ts.util.ReasonedRuntimeException - クエリ実行オブジェクトの作成に失敗した 場合、又はトランザクションの状態が不正な場合。

getQuery

IQuery getQuery(java.lang.String queryId)
                throws ts.util.ReasonedException,
                       ts.util.ReasonedRuntimeException
指定されたクエリIDに対応するクエリ・オブジェクトを取得する。

パラメータ:
queryId - クエリID。
戻り値:
クエリ・オブジェクト。
例外:
ts.util.ReasonedException - クエリが使用するコネクションの開始処理に失敗した 場合。
ts.util.ReasonedRuntimeException - クエリ・オブジェクトの作成に失敗した場合、 又はトランザクションの状態が不正な場合。


Copyright (C) SATOH Takayuki All Rights Reserved.