ts.query
インタフェース Query

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

public interface Query

クエリを実行するクラスのインターフェイス。
指定されたQueryConnectionオブジェクトが示す接続先に対して、Resourceオブジェクトと入力パラメータ・マップから作成した 実行内容を実行する。 クエリの実行結果はQueryResultオブジェクトを作成して格納し、引数として 渡されたQueryResultListオブジェクトに追加する。
クエリの実行中にエラーが発生した場合は例外をスローするが、その前に実行結果 オブジェクトを作成してQueryResultListオブジェクトに追加する。

クエリを実行する手順のイメージは以下のようになる:

     transaction : QueryTransaction
     connAFactory, connBFactory : QueryConnectionFactory
     resourceA0, resourceA1, resourceB0 : Resource

     transaction.addConnectionFactory("ConnA", connAFactory);
     transaction.addConnectionFactory("ConnB", connBFactory);
     ...

     QueryResultList resultLst = new QueryResultList();
     try {
       transaction.begin();

       QueryConnection connA = transaction.getConnection("ConnA");
       Query queryA0 = connA.getQuery(resourceA0);
       queryA0.execute("qidA00", inputMap, resultLst);
       queryA0.execute("qidA01", inputMap, resultLst);

       Query queryA1 = connA.getQuery(resourceA1);
       queryA1.execute(new String[]{"qidA10","qidA11"}, inputMap, resultLst);

       QueryConnection connB = transaction.getConnection("ConnB");
       Query queryB0 = connB.getQuery(resourceB0);
       queryB0.execute(inputMap, resultLst);

       transaction.commit();
     }
     catch (Exception e) {
       transaction.rollback();
     }
     finally {
       transaction.end();
     }

     QueryResult result0 = resultLst.getResultAt(0);
     Table table0 = result0.getResulTable();
     ...

     QueryResult result1 = resultLst.getFirstResult("qidA01");
     int resultCount = result1.getResultCount();
     ...
 

バージョン:
$Id: Query.java,v 1.4 2011-08-09 14:24:18 tayu Exp $
作成者:
佐藤隆之

入れ子のクラスの概要
static class Query.Error
          このクラスから発生しうるエラーを示す列挙型。
 
メソッドの概要
 void execute(java.util.List<java.lang.String> queryIdLst, java.util.Map<java.lang.String,java.lang.Object> inputMap, QueryResultList resultLst)
          このオブジェクトが保持するクエリの中から、指定されたリスト内のIDに対する 複数のクエリを順番に実行する。
 void execute(java.util.Map<java.lang.String,java.lang.Object> inputMap, QueryResultList resultLst)
          このオブジェクトが保持する全てのクエリを、クエリ・リソースの中で指定されて いる順番に実行する。
 void execute(java.lang.String[] queryIds, java.util.Map<java.lang.String,java.lang.Object> inputMap, QueryResultList resultLst)
          このオブジェクトが保持するクエリの中から、指定された配列内のIDに対する 複数のクエリを順番に実行する。
 void execute(java.lang.String queryId, java.util.Map<java.lang.String,java.lang.Object> inputMap, QueryResultList resultLst)
          このオブジェクトが保持するクエリの中から、指定されたIDに対する1つのクエリ を実行する。
 

メソッドの詳細

execute

void execute(java.lang.String queryId,
             java.util.Map<java.lang.String,java.lang.Object> inputMap,
             QueryResultList resultLst)
             throws ts.util.ReasonedException
このオブジェクトが保持するクエリの中から、指定されたIDに対する1つのクエリ を実行する。

パラメータ:
queryId - クエリID。
inputMap - 入力パラメータを格納したマップ。
resultLst - 実行結果を格納するQueryResultListオブジェクト。
例外:
ts.util.ReasonedException - クエリの実行中に例外が発生した場合。

execute

void execute(java.lang.String[] queryIds,
             java.util.Map<java.lang.String,java.lang.Object> inputMap,
             QueryResultList resultLst)
             throws ts.util.ReasonedException
このオブジェクトが保持するクエリの中から、指定された配列内のIDに対する 複数のクエリを順番に実行する。

パラメータ:
queryIds - クエリIDの配列。
inputMap - 入力パラメータを格納したマップ。
resultLst - 実行結果を格納するQueryResultListオブジェクト。
例外:
ts.util.ReasonedException - クエリの実行中に例外が発生した場合。

execute

void execute(java.util.List<java.lang.String> queryIdLst,
             java.util.Map<java.lang.String,java.lang.Object> inputMap,
             QueryResultList resultLst)
             throws ts.util.ReasonedException
このオブジェクトが保持するクエリの中から、指定されたリスト内のIDに対する 複数のクエリを順番に実行する。

パラメータ:
queryIdLst - クエリIDのリスト。
inputMap - 入力パラメータを格納したマップ。
resultLst - 実行結果を格納するQueryResultListオブジェクト。
例外:
ts.util.ReasonedException - クエリの実行中に例外が発生した場合。

execute

void execute(java.util.Map<java.lang.String,java.lang.Object> inputMap,
             QueryResultList resultLst)
             throws ts.util.ReasonedException
このオブジェクトが保持する全てのクエリを、クエリ・リソースの中で指定されて いる順番に実行する。

パラメータ:
inputMap - 入力パラメータを格納したマップ。
resultLst - 実行結果を格納するQueryResultListオブジェクト。
例外:
ts.util.ReasonedException - クエリの実行中に例外が発生した場合。


Copyright (C) SATOH Takayuki All Rights Reserved.