Java メソッドから結果セットを返す方法

呼び出しを行う環境に結果セットを返す Java メソッドを書き、LANGUAGE JAVA の EXTERNAL NAME であると宣言された SQL ストアドプロシージャにこのメソッドをラップします。

Java メソッドから結果セットを返すには、次のタスクを実行します。

パブリッククラスで、Java メソッドが public と static として宣言されていることを確認します。
メソッドが返すと思われる各結果セットについて、そのメソッドが java.sql.ResultSet[] 型のパラメータを持っていることを確認します。これらの結果セットパラメータは、必ずパラメータリストの最後になります。
このメソッドでは、まず java.sql.ResultSet のインスタンスを作成して、それを ResultSet[] パラメータの 1 つに割り当てます。
EXTERNAL NAME LANGUAGE JAVA 型の SQL ストアドプロシージャを作成します。この型のプロシージャは、Java メソッドのラッパーです。結果セットを返す他のプロシージャと同じ方法で、SQL プロシージャの結果セット上でカーソルを使用することができます。

Java メソッドのラッパーであるストアドプロシージャの構文の詳細については、CREATE PROCEDURE 文 [外部呼び出し]を参照してください。

例

次に示す簡単なクラスには 1 つのメソッドがあり、そのメソッドはクエリを実行して、呼び出しを行った環境に結果セットを返します。

import java.sql.*;

public class MyResultSet 
{
  public static void return_rset( ResultSet[] rset1 )
       throws SQLException 
  {
    Connection conn = DriverManager.getConnection(
                       "jdbc:default:connection" );
    Statement stmt = conn.createStatement();
    ResultSet rset =
      stmt.executeQuery (
                       "SELECT Surname " +
                       "FROM Customers" );
    rset1[0] = rset;
  }
}

結果セットを公開するには、そのプロシージャから返された結果セットの数と Java メソッドのシグネチャを指定する CREATE PROCEDURE 文を使用します。

結果セットを指定する CREATE PROCEDURE 文は、次のように定義します。

CREATE PROCEDURE result_set()
  RESULT (SurName person_name_t)
  DYNAMIC RESULT SETS 1
  EXTERNAL NAME
     'MyResultSet.return_rset([Ljava/sql/ResultSet;)V'
  LANGUAGE JAVA;

結果セットを返す SQL Anywhere プロシージャでカーソルを開くのと同じように、このプロシージャ上でカーソルを開くことができます。

文字列 ([Ljava/sql/ResultSet;)V は Java メソッドのシグネチャで、パラメータと戻り値の数や型を簡潔に文字で表現したものです。

参照

DocCommentXchange で意見交換できます