Java メソッドから返される結果セット

この項では、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 で意見交換できます