SQL Anywhere では、Java ストアド・プロシージャおよび関数をサポートしています。Java ストアド・プロシージャまたは関数の動作は、SQL ストアド・プロシージャまたは関数と同じです。ただし、プロシージャまたは関数のコードは Java で記述され、その実行はデータベース・サーバの外側 (つまり Java 仮想マシン環境内) で行われます。接続ごとに 1 つのインスタンスではなく、各データベースの Java VM に 1 つのインスタンスがあります。Java ストアド・プロシージャは結果セットを返すことができます。

データベースでの Java のサポートを使用するためには、いくつかの前提条件があります。

Java をデータベースで使用するには、データベース・サーバが Java 実行ファイルを検出して開始できることを確認してください。これは、次の文を実行して確認できます。

START EXTERNAL ENVIRONMENT JAVA;

データベース・サーバが Java を開始できない場合は、データベース・サーバが Java 実行ファイルを検出できないことが問題の原因であると考えられます。この場合は、ALTER EXTERNAL ENVIRONMENT 文を実行して、Java 実行ファイルのロケーションを明示的に設定してください。実行ファイル名を必ず含めてください。

ALTER EXTERNAL ENVIRONMENT JAVA
  LOCATION 'java-path';

次に例を示します。

ALTER EXTERNAL ENVIRONMENT JAVA
  LOCATION 'c:\\jdk1.6.0\\jre\\bin\\java.exe';

START EXTERNAL ENVIRONMENT JAVA 文は、データベース・サーバが Java VM を開始できるかどうかを確認する以外で使用することはありません。通常、Java ストアド・プロシージャまたは関数を呼び出すと、Java VM は自動的に開始されます。

これと同様に、Java のインスタンスを停止するために STOP EXTERNAL ENVIRONMENT JAVA 文を使用する必要もありません。インスタンスは、データベースへの接続がすべて切断されると自動的に停止します。ただし、Java をこれ以上使用することがなく、一部のリソースを解放する必要がある場合は、STOP EXTERNAL ENVIRONMENT JAVA 文によって Java VM の使用カウントを減分できます。

データベース・サーバが Java VM 実行ファイルを開始できることを確認したら、次に必要な Java クラス・コードをデータベースにインストールします。これは、INSTALL JAVA 文を使用して行います。たとえば、次の文を実行して Java クラスをファイルからデータベースにインストールできます。

INSTALL JAVA 
NEW 
FROM FILE 'java-class-file';

データベースには、Java JAR ファイルもインストールできます。

INSTALL JAVA 
NEW
JAR 'jar-name'
FROM FILE 'jar-file';

Java クラスは、次のようにして変数からインストールできます。

CREATE VARIABLE JavaClass LONG VARCHAR;
SET JavaClass = xp_read_file('java-class-file')
INSTALL JAVA 
NEW
FROM JavaClass;

Java JAR ファイルは、次のようにして変数からインストールできます。

CREATE VARIABLE JavaJar LONG VARCHAR;
SET JavaJar = xp_read_file('jar-file')
INSTALL JAVA 
NEW
JAR 'jar-name'
FROM JavaJar;

Java クラスをデータベースから削除するには、次のように REMOVE JAVA 文を使用します。

REMOVE JAVA CLASS 'java-class'

Java JAR をデータベースから削除するには、次のように REMOVE JAVA 文を使用します。

REMOVE JAVA JAR 'jar-name'

既存の Java クラスを変更するには、次のように INSTALL JAVA 文の UPDATE 句を使用します。

INSTALL JAVA 
UPDATE
FROM FILE 'java-class-file'

データベース内の既存の Java JAR ファイルを更新することもできます。

INSTALL JAVA 
UPDATE
JAR 'jar-name'
FROM FILE 'jar-file';

Java クラスは、次のようにして変数から更新できます。

CREATE VARIABLE JavaClass LONG VARCHAR;
SET JavaClass = xp_read_file('java-class-file')
INSTALL JAVA 
UPDATE
FROM JavaClass;

Java JAR ファイルは、次のようにして変数から更新できます。

CREATE VARIABLE JavaJar LONG VARCHAR;
SET JavaJar = xp_read_file('jar-file')
INSTALL JAVA 
UPDATE
FROM JavaJar;

Java クラスをデータベースにインストールしたら、次に Java メソッドへのインタフェースとなるストアド・プロシージャおよび関数を作成できます。EXTERNAL NAME 文字列には、Java メソッドを呼び出し、OUT パラメータおよび戻り値を返すために必要な情報が含まれています。EXTERNAL NAME 句の LANGUAGE 属性には JAVA を指定する必要があります。EXTERNAL NAME 句のフォーマットは次のとおりです。

EXTERNAL NAME 'java-call' LANGUAGE JAVA

java-call :
[package-name.]class-name.method-name method-signature

method-signature : 
( [ field-descriptor, ... ] ) return-descriptor

field-descriptor and return-descriptor :
Z 
| B 
| S 
| I 
| J 
| F 
| D 
| C 
| V 
| [descriptor 
| Lclass-name;

Java メソッド・シグニチャは、パラメータの型と戻り値の型を簡潔に文字で表現したものです。パラメータの数がメソッド・シグニチャに指定された数字よりも小さい場合は、この差が DYNAMIC RESULT SETS に指定された数と等しくなるようにします。また、プロシージャ・パラメータ・リストよりも多いメソッド・シグニチャ内の各パラメータには、メソッド・シグニチャ [Ljava/SQL/ResultSet; が必要です。

field-descriptor と return-descriptor の意味は次のとおりです。

次に例を示します。

double some_method(
  boolean a,
  int b,
  java.math.BigDecimal c,
  byte [][] d,
  java.sql.ResultSet[] rs ) {
}

この例では、次のシグニチャを得られます。

'(ZILjava/math/BigDecimal;[[B[Ljava/SQL/ResultSet;)D'

次のプロシージャは、Java メソッドへのインタフェースを作成するものです。この Java メソッドはいかなる値も返しません (V)。

CREATE PROCEDURE insertfix() 
EXTERNAL NAME 'JDBCExample.InsertFixed()V' 
LANGUAGE JAVA;

次のプロシージャは、String ([Ljava/lang/String;) 入力引数を持つ Java メソッドへのインタフェースを作成するものです。この Java メソッドはいかなる値も返しません (V)。

CREATE PROCEDURE InvoiceMain( IN arg1 CHAR(50) )
EXTERNAL NAME 'Invoice.main([Ljava/lang/String;)V'
LANGUAGE JAVA;

次のプロシージャは、Java メソッド Invoice.init へのインタフェースを作成するものです。この Java メソッドは、文字列引数 (Ljava/lang/String;)、double (D)、別の文字列引数 (Ljava/lang/String;)、別の double (D) を受け取り、値を返しません (V)。

CREATE PROCEDURE init( IN arg1 CHAR(50),
                       IN arg2 DOUBLE, 
                       IN arg3 CHAR(50), 
                       IN arg4 DOUBLE) 
EXTERNAL NAME 'Invoice.init(Ljava/lang/String;DLjava/lang/String;D)V'
LANGUAGE JAVA

Java メソッドの呼び出しに関する詳細については、Java クラスのメソッドへのアクセスを参照してください。

返される結果セットの詳細については、Java メソッドから返される結果セットを参照してください。

次に示す Java の例は、文字列を受け取り、それをデータベース・サーバ・メッセージ・ウィンドウに書き込みます。

import java.io.*;

public class Hello
{
    public static void main( String[] args )
    {
        System.out.print( "Hello" );
               for ( int i = 0; i  < args.length; i++ )
                   System.out.print( " " + args[i] );
        System.out.println();
    }
}

上記の Java コードは、Hello.java ファイルにあり、Java コンパイラを使用してコンパイルします。生成されるクラス・ファイルは次のようにデータベースにロードされます。

INSTALL JAVA 
NEW 
FROM FILE 'Hello.class';

Hello クラスの main メソッドへのインタフェースとなるストアド・プロシージャは、Interactive SQL を使用して次のように作成されます。

CREATE PROCEDURE HelloDemo( IN name LONG VARCHAR ) 
EXTERNAL NAME 'Hello.main([Ljava/lang/String;)V'
LANGUAGE JAVA;

main の引数は java.lang.String の配列として記述されています。Interactive SQL で次の SQL 文を実行することでインタフェースをテストします。

CALL HelloDemo('SQL Anywhere');

メッセージは、データベース・サーバ・メッセージ・ウィンドウに表示されます。System.out への出力はすべてサーバ・メッセージ・ウィンドウにリダイレクトされます。

データベースでの Java サポートの使用に関する詳細および例については、SQL Anywhere での Java サポートを参照してください。