ts.query
インタフェース QueryConnection


public interface QueryConnection

クエリを実行する対象への接続を表すコネクション・クラスのインターフェイス。
接続を操作するためのメソッドopen()commit()rollback()close()を宣言している。 これらのメソッドはQueryTransactionオブジェクトから呼び出される。
またこのクラスは、クエリを実行するQueryオブジェクトを取得するための メソッドgetQuery(QueryResource)、そのメソッドの中でQueryContentオブジェクトに格納された実行内容を実行するexecuteContent(QueryContent)メソッド、実行したクエリの結果を格納するQueryResultListオブジェクトを取得するためのメソッドgetTransactionQueryResultList()を宣言している。

バージョン:
$Id: QueryConnection.java,v 1.8 2011-09-18 16:15:16 tayu Exp $
作成者:
佐藤隆之

メソッドの概要
 void close()
          接続を終了する。
 void commit()
          接続先への更新を確定する。
 int executeContent(QueryContent cont)
          引数のQueryContentオブジェクトに格納されたクエリの実行内容を、 このオブジェクトが示す接続先に対して実行する。
 int executeContent(QueryContent cont, ts.util.table.Table<java.lang.String,java.lang.Object> table)
          引数のQueryContentオブジェクトに格納されたクエリの実行内容を、 このオブジェクトが示す接続先に対して実行する。
 java.lang.String getId()
          接続先を識別するコネクションIDを取得する。
 long getLimitTimeMillis()
          クエリ実行のタイムアウトのリミット時刻をミリ秒単位で取得する。
 Query getQuery(QueryResource resource)
          クエリ・オブジェクトを作成する。
 QueryResultList getTransactionQueryResultList()
          このコネクションが属するトランザクションのクエリ実行結果リストを取得する。
 boolean isClosed()
          このオブジェクトが示す接続先へのコネクションが閉じられたかどうかを確認 する。
 void open()
          接続を開始する。
 void rollback()
          接続先への更新を取り消す。
 

メソッドの詳細

getId

java.lang.String getId()
接続先を識別するコネクションIDを取得する。


open

void open()
接続を開始する。


commit

void commit()
接続先への更新を確定する。


rollback

void rollback()
接続先への更新を取り消す。


close

void close()
接続を終了する。


isClosed

boolean isClosed()
このオブジェクトが示す接続先へのコネクションが閉じられたかどうかを確認 する。

戻り値:
コネクションが閉じられている場合はtrueを返す。

getLimitTimeMillis

long getLimitTimeMillis()
クエリ実行のタイムアウトのリミット時刻をミリ秒単位で取得する。
戻り値が負値の場合は、リミット時刻が指定されていないものとする。

戻り値:
タイムアウトのリミット時刻[msec]。

getQuery

Query getQuery(QueryResource resource)
クエリ・オブジェクトを作成する。
引数に指定されたリソースと、内部に保持するコネクション・オブジェクトを 使ってクエリを実行するQueryオブジェクトを作成して返す。

パラメータ:
resource - クエリの実行内容の元となる情報を格納するQueryResourceオブジェクト。
戻り値:
Queryオブジェクト。

executeContent

int executeContent(QueryContent cont,
                   ts.util.table.Table<java.lang.String,java.lang.Object> table)
                   throws ts.util.ReasonedException
引数のQueryContentオブジェクトに格納されたクエリの実行内容を、 このオブジェクトが示す接続先に対して実行する。

パラメータ:
cont - QueryContentオブジェクト。
table - クエリを実行した結果として取得されたデータを格納するTableオブジェクト。
戻り値:
クエリを実行して処理されたデータの件数。
例外:
ts.util.ReasonedException - クエリの実行に失敗した場合。

executeContent

int executeContent(QueryContent cont)
                   throws ts.util.ReasonedException
引数のQueryContentオブジェクトに格納されたクエリの実行内容を、 このオブジェクトが示す接続先に対して実行する。

パラメータ:
cont - QueryContentオブジェクト。
戻り値:
クエリを実行して処理されたデータの件数。
例外:
ts.util.ReasonedException - クエリの実行に失敗した場合。

getTransactionQueryResultList

QueryResultList getTransactionQueryResultList()
このコネクションが属するトランザクションのクエリ実行結果リストを取得する。

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


Copyright (C) SATOH Takayuki All Rights Reserved.