この章では、オブジェクト参照へのアクセスおよび操作を行う、標準Java Database Connectivity(JDBC)について説明します。
この項の内容は次のとおりです。
Oracleでは、データベース・オブジェクトへの参照を使用できます。Oracle JDBCでは、次のオブジェクト参照がサポートされます。
SELECT
句の列
INまたはOUTバインド変数
Oracleオブジェクトの属性
コレクション型オブジェクトの要素
SQLでは、オブジェクト参照(REF
)は厳密に型指定されています。たとえば、EMPLOYEE
オブジェクトへの参照は、REF
のみではなく、EMPLOYEE REF
として定義されます。
オブジェクト参照を選択する場合は、オブジェクト本体でなく、オブジェクトへのポインタのみを取得することに注意してください。移植性を重視して、参照をjava.sql.Ref
インスタンスとしてインスタンス化するか、事前に作成したカスタムJavaクラスのインスタンスとしてインスタンス化して強い型指定の利点を取るか、両方の選択肢があります。オブジェクト参照のために使用されるカスタムJavaクラスは、カスタム参照クラスとして参照されるため、oracle.sql.ORAData
インタフェースを実装する必要があります。
結果セットまたはコール可能文オブジェクトを介してREF
インスタンスを取得し、プリコンパイルされたSQL文またはコール可能文オブジェクトを介して更新されたREF
にインスタンスをデータベースに戻すことができます。REF
クラスには、基礎となるオブジェクト属性値を取得および設定し、基礎となるオブジェクトのSQLベース型名を取得する機能があります。
カスタム参照クラスには、これと同じ機能が含まれている他に、強い型指定が適用されるという利点があります。この強い型指定により、実行時まで検出できないコーディング・エラーを、コンパイル時に発見できます。
注意:
|
この項では、オブジェクト参照の取出しと引渡しを行うJDBC機能を説明します。内容は次のとおりです。
オブジェクト参照を取り出す方法を示すために、次の例では、最初に、Oracleオブジェクト型ADDRESS
を定義し、次にPEOPLE
表でこのオブジェクト型を参照します。
create type ADDRESS as object (street_name VARCHAR2(30), house_no NUMBER); create table PEOPLE (col1 VARCHAR2(30), col2 NUMBER, col3 REF ADDRESS);
ADDRESS
オブジェクト型には、street nameとhouse numberという2つの属性があります。PEOPLE
表には、文字データ用の列、数値データ用の列、およびADDRESS
オブジェクトへの参照を含む列が設定されています。
オブジェクト参照を取り出すには、次の手順に従ってください。
Address
をSQLオブジェクト型のADDRESS
に対応するJavaカスタム・クラスに変換します。
JavaクラスAddress
とSQL型ADDRESS
間の対応を、型マップに追加します。
また、PEOPLE
データベース表の定義については、この項の始めの説明を参照してください。前述の手順を実行するコードは、Address
を型マップに追加する手順を除いて、次のようになります。
ResultSet rs = stmt.executeQuery("SELECT col3 FROM PEOPLE"); while (rs.next()) { REF ref = rs.getRef(1); Address a = (Address)ref.getObject(); }
注意: 前述のコードで、stmt はあらかじめ定義されている文オブジェクトです。 |
オブジェクト参照をPL/SQLブロックのOUT
パラメータとして取り出すには、OUT
パラメータのバインド型を登録する必要があります。
次のように、コール可能文をOracleCallableStatement
にキャストします。
OracleCallableStatement ocs = (OracleCallableStatement)conn.prepareCall("{? = call func()}");
次の形式のregisterOutParameter
メソッドを使用して、OUT
パラメータを登録します。
ocs.registerOutParameter (int param_index, int sql_type, String sql_type_name);
param_index
はパラメータ索引、sql_type
はSQL型コードです。sql_type_name
は、この参照が使用される構造化オブジェクト型の名前です。たとえば、OUT
パラメータがADDRESS
オブジェクトに対する参照の場合、ADDRESS
は渡されるsql_type_name
です。
次のように、コールを実行します。
ocs.execute();
オブジェクト参照をプリコンパイルされたSQL文に渡す方法は、他のSQL型を渡す場合と同様です。プリコンパイルされたSQL文のオブジェクトのsetObject
メソッドまたはsetREF
メソッドを使用します。
次のプリコンパイルされたSQL文を使用し、ROWID
に基づいてアドレス参照を更新します。
PreparedStatement pstmt = conn.prepareStatement ("update PEOPLE set ADDR_REF = ? where ROWID = ?"); pstmt.setRef (1, addr_ref); pstmt.setRowId (2, rowid);
Ref
オブジェクトのsetObject
メソッドを使用すると、データベースにあるオブジェクトの値をオブジェクト参照から更新できます。このためには、最初に、データベース・オブジェクトに対する参照を取り出し、データベース・オブジェクトに対応するJavaオブジェクトを作成する必要があります。
たとえば、次のように、「オブジェクト参照の取出しと引渡し」のコードを使用して、データベースのADDRESS
オブジェクトへの参照を取り出せます。
ResultSet rs = stmt.executeQuery("SELECT col3 FROM PEOPLE"); if (rs.next()) { Ref ref = rs.getRef(1); Address a = (Address)ref.getObject(); }
次に、データベースのADDRESS
オブジェクトに対応するJavaのAddress
オブジェクトを作成できます。次のように、Ref
インタフェースのsetObject
メソッドを使用して、データベース・オブジェクトの値を設定します。
Address addr = new Address(...); ref.setObject(addr);
この例では、setValue
メソッドによりデータベースのADDRESS
オブジェクトが即時更新されます。
この章では、java.sql.Ref
クラスの機能を主に説明していますが、カスタムJavaクラス、より厳密にはカスタム参照クラスからも、Oracleオブジェクト参照にアクセスできます。
カスタム参照クラスには、この章でここまで説明してきたすべての機能に加え、強い型指定が適用されるという利点があります。カスタム参照クラスは、次の3つの要件を満たす必要があります。
oracle.sql.ORAData
インタフェースを実装する必要があります。カスタム・オブジェクト・クラス用の代替である標準JDBC SQLData
インタフェースは、カスタム参照クラスには使用できないので注意してください。
コンパニオン・クラスの場合は、カスタム参照クラスのインスタンスを作成するために、oracle.sql.ORADataFactory
インタフェースを実装する必要があります。
オブジェクト・データを参照する方法を用意する必要があります。JPublisherは、oracle.sql.REF
属性を使用することにより、これを実現します。
カスタム参照クラスは独自にも作成できますが、Oracle JPublisherユーティリティを使用して作成すると便利です。JPublisherを使用して、Oracleオブジェクトにマップするためのカスタム・オブジェクト・クラスを生成し、JPublisherがORAData
実装を使用するように指定した場合、JPublisherは、ORAData
とORADataFactory
を実装して、oracle.sql.REF
属性を含むカスタム参照クラスも生成します。JPublisher -usertypes
マッピング・オプションがoracle
に設定されている場合(デフォルト)、ORAData
実装が使用されます。
カスタム参照クラスは、強い型指定です。たとえば、OracleオブジェクトEMPLOYEE
を定義すると、JPublisherによりEmployee
カスタム・オブジェクト・クラスおよびEmployeeRef
カスタム参照クラスが生成されます。汎用oracle.sql.REF
インスタンスのかわりにEmployeeRef
インスタンスを使用すると、実行時ではなくコンパイル時にエラーを簡単に捕捉できます。たとえば、EmployeeRef
変数に別の種類のオブジェクト参照を間違えて割り当てた場合は、簡単にエラーが検出されます。
標準SQLData
インタフェースはSQLオブジェクト・マッピングのみをサポートすることに注意してください。このため、JPublisherがカスタム・オブジェクト・クラスを作成する際に標準SQLData
インタフェースを実装するように指定した場合、JPublisherはカスタム参照クラスを生成しません。この場合、唯一のオプションは、標準java.sql.Ref
インスタンスまたはoracle.sql.REF
インスタンスを使用して、オブジェクト参照にマップすることです。