ts.query
クラス Query

java.lang.Object
  上位を拡張 ts.query.Query
すべての実装されたインタフェース:
IQuery
直系の既知のサブクラス:
ControllableQuery

public class Query
extends java.lang.Object
implements IQuery

1つのまとまったクエリを表すクラス。
任意の接続先に対する一つ又は複数の照会や更新からなるクエリを処理し、結果を IQueryResultに格納して返す。

バージョン:
$Id: Query.java,v 1.23 2012-03-13 18:54:42 tayu Exp $
作成者:
佐藤隆之

コンストラクタの概要
protected Query(QueryConfig config)
          クエリ設定オブジェクトを引数にとるコンストラクタ。
protected Query(QueryConfig config, IQueryTransaction tran)
          クエリ設定オブジェクトとクエリ・トランザクション・オブジェクトを引数とる コンストラクタ。
 
メソッドの概要
protected  void controlTransaction(java.util.Map<java.lang.String,java.lang.Object> inputMap, QueryResult result)
          トランザクションの制御を行う。
protected  IQueryTransaction createDefaultTransaction()
          外部からトランザクションを渡されなかった場合に、使用するトランザクションを 自分で作成する。
 IQueryResult execute(java.util.Map<java.lang.String,java.lang.Object> inputMap)
          このオブジェクトが表すクエリを実行する。
protected  void executeQuery(java.util.Map<java.lang.String,java.lang.Object> inputMap, QueryResult result)
          クエリを実行する。
protected  QueryConfig getConfig()
          クエリ設定オブジェクトを取得する。
 IQueryHistory getQueryHistory()
          クエリの実行履歴を取得する。
protected  IQueryTransaction getTransaction()
          クエリ・トランザクション・オブジェクトを取得する。
protected  boolean isNeededToControlTransaction()
          このオブジェクトの中でトランザクションの制御か必要かどうかを判定する。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

Query

protected Query(QueryConfig config)
クエリ設定オブジェクトを引数にとるコンストラクタ。

パラメータ:
config - クエリ設定オブジェクト。
例外:
java.lang.AssertionError - 引数がヌルの場合(デバッグ・モードのみ)。

Query

protected Query(QueryConfig config,
                IQueryTransaction tran)
クエリ設定オブジェクトとクエリ・トランザクション・オブジェクトを引数とる コンストラクタ。

パラメータ:
config - クエリ設定オブジェクト。
tran - クエリ・トランザクション・オブジェクト。
例外:
java.lang.AssertionError - 引数がヌルの場合(デバッグ・モードのみ)。
メソッドの詳細

createDefaultTransaction

protected IQueryTransaction createDefaultTransaction()
外部からトランザクションを渡されなかった場合に、使用するトランザクションを 自分で作成する。

戻り値:
自分で使用するトランザクション・オブジェクト。

getConfig

protected QueryConfig getConfig()
クエリ設定オブジェクトを取得する。

戻り値:
クエリ設定オブジェクト。

getTransaction

protected IQueryTransaction getTransaction()
クエリ・トランザクション・オブジェクトを取得する。

戻り値:
クエリ・トランザクション・オブジェクト。

getQueryHistory

public IQueryHistory getQueryHistory()
クエリの実行履歴を取得する。

定義:
インタフェース IQuery 内の getQueryHistory
戻り値:
IQueryHistoryオブジェクト。

isNeededToControlTransaction

protected boolean isNeededToControlTransaction()
このオブジェクトの中でトランザクションの制御か必要かどうかを判定する。

戻り値:
トランザクションの制御が必要な場合はtrue

execute

public IQueryResult execute(java.util.Map<java.lang.String,java.lang.Object> inputMap)
                     throws ts.util.ReasonedException,
                            ts.util.ReasonedRuntimeException
このオブジェクトが表すクエリを実行する。 実行結果は、QueryResultオブジェクトに格納して返す。

定義:
インタフェース IQuery 内の execute
パラメータ:
inputMap - 入力パラメータ・マップ。
戻り値:
クエリの実行結果を格納したQueryResultオブジェクト。
例外:
ts.util.ReasonedException - クエリの実行に失敗した場合。
ts.util.ReasonedRuntimeException - クエリを実行するための設定等に誤りがあった 場合。

controlTransaction

protected void controlTransaction(java.util.Map<java.lang.String,java.lang.Object> inputMap,
                                  QueryResult result)
                           throws ts.util.ReasonedException,
                                  ts.util.ReasonedRuntimeException
トランザクションの制御を行う。
トランザクションの開始から終了までの制御と、その間のクエリの実行を処理 する。

パラメータ:
inputMap - 入力パラメータ・マップ。
result - クエリ結果オブジェクト。
例外:
ts.util.ReasonedException - トランザクションの制御やクエリの実行に失敗した 場合。
ts.util.ReasonedRuntimeException - クエリ設定に不正があった場合。

executeQuery

protected void executeQuery(java.util.Map<java.lang.String,java.lang.Object> inputMap,
                            QueryResult result)
                     throws ts.util.ReasonedException,
                            ts.util.ReasonedRuntimeException
クエリを実行する。
このオブジェクトが保持するクエリ設定で指定されている実行IDに対応するIQueryExecutionオブジェクト(複数可)を処理する。

パラメータ:
inputMap - 入力パラメータ・マップ。
result - クエリ結果オブジェクト。
例外:
ts.util.ReasonedException - IQueryExecutionオブジェクトの処理に失敗 した場合。
ts.util.ReasonedRuntimeException - クエリ設定や実行設定が不正だった場合。


Copyright (C) SATOH Takayuki All Rights Reserved.