1.10.1　外部Javaルーチン

(a)　形式

　外部Javaルーチン名：：＝'JARファイル名:Javaメソッド名〔Javaシグネチャ〕'
 
　Javaメソッド名：：＝Javaクラス名.メソッド識別子
　Javaクラス名：：＝〔パッケージ名.〕クラス識別子
　Javaシグネチャ：：＝（〔Javaパラメタ〕）〔returns 型名〕
　Javaパラメタ：：＝型名〔，型名〕…

(b)　説明

JARファイル名

Javaで定義したクラス又はパッケージの集合である，アーカイブファイルの名称を指定します。

JARファイル名は，パス名で指定しないでください。JARファイル名は，最大255バイトで指定できます。

メソッド識別子

実際に処理が記述されているJavaメソッドの識別子を指定します。

メソッド識別子は，最大255バイトで指定できます。

パッケージ名

Javaで定義したクラスの集合である，パッケージの名称を指定します。

クラス識別子

Javaメソッドが定義されているクラスの識別子を指定します。

パッケージ名と合わせて，最大255バイトで指定できます。

returns 型名

Javaメソッドの引数及び戻り値に対応するJavaの型名を指定します。

外部Java手続きを定義する場合は，戻り値の型名をvoid（戻り値なし）にするか，"returns 型名"を省略してください。

外部Java関数を定義する場合は，"returns 型名"を必ず指定してください。ただし，Javaシグネチャを省略する場合は"returns 型名"を指定する必要はありません。なお，外部Java関数では戻り値の型名にvoid（戻り値なし）は指定できません。

型名〔，型名〕…

Javaメソッドの引数及び戻り値に対応するJavaの型名を指定します。

規則を次に示します。

1. Javaパラメタで記述するJavaメソッドのパラメタの型名は，CREATE PROCEDURE及びCREATE FUNCTIONで指定したSQLパラメタ名の順番に記述してください。

2. SQLパラメタ名に対応するJavaメソッドのパラメタの型名をすべて記述してください。

3. CREATE PROCEDUREのDYNAMIC RESULT SETS句で結果集合の最大数を1以上にした場合，指定した結果集合の最大個数以下の型名"java.sql.ResultSet[]"を，Javaパラメタの最後に指定してください。

4. CREATE FUNCTIONで関数を定義する場合は，HiRDBのデータ型とマッピングできるJavaデータ型を指定します。

   CREATE PROCEDUREで定義する手続きでSQLパラメタの入出力モードがINの場合は，HiRDBのデータ型とマッピングできるJavaデータ型を指定します。

   CREATE PROCEDUREで定義する手続きでSQLパラメタの入出力モードがOUT又はINOUTの場合は，HiRDBのデータ型とマッピングできるJavaデータ型の一次元の配列型を指定します。

   例えば，INTEGERやBLOBの出力パラメタに対しては，java.lang.Integer[]やbyte[] []で指定します。なお，HiRDBのデータ型とマッピングできるJavaデータ型については，「型マッピング」を参照してください。

(c)　規則

1. Javaシグネチャを省略すると，外部Java手続き又は外部Java関数定義で指定しているHiRDBのデータ型と，SQLパラメタの入出力モードを基に，次に示す規則でJavaデータ型が決定されます。

   • CREATE FUNCTIONで関数を定義する場合，Javaメソッドのデータ型はマッピング規則に従って決定されます。

   • CREATE PROCEDUREで定義する手続きのSQLパラメタの入出力モードがINの場合，Javaメソッドのデータ型はマッピング規則に従って決定されます。

   • CREATE PROCEDUREで定義する手続きのSQLパラメタの入出力モードがOUT又はINOUTの場合，Javaメソッドのデータ型はマッピング規則の一次元の配列型で決定されます。

   • CREATE PROCEDUREのDYNAMIC RESULT SETS句で結果集合の最大数を1以上指定してJavaシグネチャを省略した場合は，マッピング規則で決定したデータ型から更に，java.sql.ResultSet[]型のパラメタが，Javaメソッドのパラメタとして結果集合の最大個数分追加されます。

   例えば，INTEGERやBLOBの出力パラメタに対しては，java.lang.Integer[]やbyte[] []が決定されます。なお，マッピング規則については，「型マッピング」を参照してください。

2. 外部ルーチン名は，必ずアポストロフィ（’）で囲んでください。

3. 外部ルーチン名で指定できるJavaメソッドは，クラス定義のstaticで宣言したクラスメソッドだけです。

4. 各項目に指定できる文字を次に示します。

   • JARファイル名

     アルファベットの大文字と小文字，数字，'_'（アンダースコア），'$'，'.'，'-'

   • クラス識別子，メソッド識別子，型名

     アルファベットの大文字と小文字，数字，'_'（アンダースコア），'$'

   • パッケージ名

     アルファベットの大文字と小文字，数字，'_'（アンダースコア），'$'，'.'

5. パッケージ名，クラス識別子，メソッド識別子，及び型名の先頭一文字には数字を指定できません。

6. パッケージ名を省略した型名を記述する場合，HiRDBは次のようにパッケージ名を含む型名として解釈します。

   省略した場合の記述形式	HiRDBが解釈するパッケージ名を含む型名
   Integer	java.lang.Integer
   Short	java.lang.Short
   BigDecimal	java.math.BigDecimal
   Double	java.lang.Double
   Float	java.lang.Float
   String	java.lang.String
   Date	java.sql.Date
   Time	java.sql.Time
   Timestamp	java.sql.Timestamp
   ResultSet	java.sql.ResultSet