18.3.8　カーソルによる検索の記述

(a)　位置指定反復子クラスの定義と反復子オブジェクトの宣言

• スタンダードインタフェース版の場合

  スタンダードインタフェース版の場合，位置指定反復子のクラスを定義して，反復子オブジェクトを宣言します。クラス名はJavaの識別子です。データ型Nは，FETCH文でN番目の検索項目を格納するJavaの変数のデータ型です。

   #sql 修飾子 iterator クラス名
                 (データ型１,データ型2,…) ;
   修飾子 クラス名 反復子オブジェクト ;

• ネイティブインタフェース版の場合

  ネイティブインタフェース版の場合，次のようになります。

   #sql 修飾子 iterator クラス名
             [ implements JP.co.Hitachi.soft.HiRDB.pdjpp.runtime.ForUpdate ]
             [ with キーワード=設定値,…]
                 (データ型１,データ型2,…) ;
   修飾子 クラス名 反復子オブジェクト ;

  UPDATE文，DELETE文で反復子を使用する場合，JP.co.Hitachi.soft.HiRDB.pdjpp.runtime.ForUpdateインタフェースを継承します。

  WITH句のキーワードは，反復子の機能を示します。設定値は定数だけです。WITH句のキーワードと値の組み合わせを次の表に示します。

  表18‒7　WITH句のキーワードと値の組み合わせ

  WITH句のキーワード	機能	設定値
  holdability	ホールダブルカーソルであることを示します。	TRUE
  updateColumns	更新する列を示します。	"列名,列名,…"

(b)　カーソルの定義とオープン

宣言した反復子オブジェクトに，SELECT文の結果セットを代入します。

 #sql [コンテキスト] 反復子オブジェクト = { SELECT文 } ;

(c)　検索結果の取り出し

カーソル名の代わりに，反復子オブジェクトを指定してFETCH文を実行します。反復子オブジェクトは，先頭にコロンを付けます。

 #sql [コンテキスト] {
    FETCH :反復子オブジェクト INTO :変数1,:変数2,…} ;

(d)　NOT FOUNDの判定

反復子オブジェクトのendFetchメソッドを呼び出して，NOT FOUNDかどうかを判定します。検索する行がない場合はtrueが返ります。次の行がある場合はfalseが返ります。カーソルを閉じた後に呼んだ場合はtrueが返ります。

 while(! 反復子オブジェクト.endFetch()) {
      取り出した行に対する処理
 }

(e)　カーソルのクローズ

カーソルをクローズする場合は，closeメソッドを呼び出します。

 反復子オブジェクト.close() ;

FETCH文を使用した検索例を次に示します。

 #sql public iterator ByPos(String, int);
                   :
 {
   ByPos positer;
   String name = null;
   int code = 0;
 
   #sql positer = { SELECT SNAME,SCODE FROM ZAIKO };
   #sql { FETCH :positer INTO :name,:code };
   while( !positer.endFetch() ){
     System.out.println(name + ":" + code);
     #sql { FETCH :positer INTO :name,:scode };
   }
   positer.close();
 }

(a)　列名指定反復子クラスの定義

検索項目と同じ名称（大文字と小文字は区別しない）を，クラスのフィールドとして定義します。データ型は，検索結果を受け取るJavaの変数のデータ型を指定します。なお，ネイティブインタフェースの場合は使用できません。

検索項目が，値式，Javaで使用できない文字を含む列名などの場合，AS句で検索項目に別名を定義しておいて，その別名を使用します。

 #sql 修飾子 iterator クラス名
            (データ型1 列名1,
             データ型2 列名2,…) ;
 修飾子 クラス名 反復子オブジェクト;

(b)　カーソルの定義とOPEN

宣言した反復子オブジェクトに，SELECT文の結果セットを代入します。

 #sql [コンテキスト] 反復子オブジェクト = { SELECT文 } ;

(c)　次の行の取り出しとNOT FOUNDの判定

反復子オブジェクトのnextメソッドを呼び出して，NOT FOUNDかどうかを判定します。NOT FOUNDの場合はTRUEが返ります。行がある場合はFALSEが返ります。カーソルがオープンした後，最初のnextメソッドが実行されるまで，カーソルは検索結果の最初の行に位置づけられません。

 while(反復子オブジェクト.next()){
     取り出した行に対する処理
 }

(d)　検索結果の取得

反復子オブジェクトの各フィールドから，データを読み出します。NOT FOUNDの場合や，カーソルがクローズされた後に読み出すと，結果は不定となります。フィールドのデータ型がJavaの基本データ型で，検索結果がナル値の場合に読み出すと，SQLNullExceptionオブジェクトが発生します。

フィールドに対して代入しても，データベースには反映されません。

 変数1 = 反復子オブジェクト.列名1 ;
 変数2 = 反復子オブジェクト.列名2 ;
              ：

(e)　カーソルのCLOSE

反復子オブジェクトのcloseメソッドを呼び出します。

 反復子オブジェクト.close() ;

FETCH文を使用しない検索例を次に示します。

(例)

 #sql public iterator ByName(String sname,
                            int scode);
                  :
 {
    ByName nameiter;
    String s;
    int i;
 
    #sql nameiter = { SELECT SNAME, SCODE FROM ZAIKO };
    while( nameiter.next() ){
      s = nameiter.sname();
      i = nameiter.scode();
      System.out.println(s + ":" + i);
    }
    nameiter.close();
 }