9 SQL 型のカスタマイズ

9.1     型のマッピング

各 Connection には、それぞれ対応する型マッピングオブジェクトがあります。型マッピングオブジェクトには、その接続で行う処理の中で使用する SQL ユーザ定義型のデータを変換するための、型対応表が含まれています。また、接続で使用する型の対応付けを取得および設定するためのメソッドも提供されています。次に例を示します。

java.util.Map map = con.getTypeMap();
con.setTypeMap(map);

マッピング機構は非常に柔軟性があります。 JDBC アプリケーションで、特定の接続の型マッピングが明示的に初期化されていない場合、その接続で行われる処理では、第 8 章で説明しているデフォルトのマッピングが使用されます。特定の SQL 型の型マッピングにカスタムマッピングが挿入されている場合は、その接続で行われるすべての処理で、その SQL 型の値に対してこのカスタムマッピングが使用されます。なお、getXXX() メソッドと setXXX() メソッドの呼び出し時に型マッピングオブジェクトを明示的に指定することで、特定の Connection に対応するカスタムマッピングまたはデフォルトのマッピングをオーバーライドすることも可能です。

9.2     Java クラスに関する規約

SQL と Java の間でのデータのやりとりにストリームを使用するというこの方法は、考え方としては Java のオブジェクト直列化に似ています。データの読み書きは、JDBC ドライバの提供する SQL データストリームを介して行われます。SQL データストリームは、さまざまなネットワークプロトコル上にさまざまなデータ形式のものが実装できます。SQL データストリームは、それを介して、構造化型の「深さ優先」の走査形式でリーフ SQL データ項目 (SQL の構造化型の構成要素) を読み出す (または書き込む) ことができる、任意の論理的データ表現上に実装できます。つまり、SQL の構造化型の属性は、型宣言部分で記述されている順序でストリームに現れ、それぞれの属性 (おそらくは構造化された属性) の値は、次の属性より前に完全に現れます (その構造を再帰的に走査)。継承を使用する SQL の構造化型のデータの場合は、属性は継承された順序でストリームに現れなければなりません。つまり、スーパータイプの属性がサブタイプの属性より前に現れなければなりません。多重継承を使用している場合は、スーパータイプは、型宣言部分で記述されている順序でストリームに現れるようにすべきです。このプロトコルでは、データベースサーバ側に Java に関する知識は必要ありません。

9.3     SQL データのストリーム

9.3.1 データの取得

this.str = sqlin.readString();
this.blob = sqlin.readBlob();
this.emp = (Employee)sqlin.readObject();

SQLInput インタフェースには、これ以外にも、さまざまな型のデータを読み出すための readXXX() メソッドがいくつか定義されています。readXXX() メソッドから返された値が null でないかどうかは、SQLInput.wasNull() メソッドでチェックできます。

9.3.2 データの格納

sqlout.writeString(this.str);
sqlout.writeBlob(this.blob);
sqlout.writeObject(this.emp);

9.4 例

9.4.1 SQL の構造化型の例

CREATE TYPE RESIDENCE 
(
	DOOR NUMERIC(6),
	STREET VARCHAR(100), 
	CITY VARCHAR(50),
	OCCUPANT REF(PERSON)
);

CREATE TYPE FULLNAME
(
	FIRST VARCHAR(50),
	LAST VARCHAR(50)
);

CREATE TYPE PERSON 
(
	NAME FULLNAME,
	HEIGHT NUMERIC,
	WEIGHT NUMERIC,
	HOME REF(RESIDENCE)
);


CREATE TABLE HOMES OF RESIDENCE (OID REF(RESIDENCE) 
	VALUES ARE SYSTEM GENERATED);

CREATE TABLE PEOPLE OF PERSON (OID REF(PERSON) 
	VALUES ARE SYSTEM GENERATED);

INSERT INTO PEOPLE (SURNAME, HEIGHT, WEIGHT) VALUES 
(
	FULLNAME('DAFFY', 'DUCK'), 
	4, 
	58
);

INSERT INTO HOMES (DOOR, STREET, CITY, OCCUPANT) VALUES 
(
	1234, 
	'CARTOON LANE', 
	'LOS ANGELES',
	(SELECT OID FROM PEOPLE P WHERE P.NAME.FIRST = 'DAFFY')
);

UPDATE PEOPLE SET HOME = (SELECT OID FROM HOMES H WHERE 
        H.OCCUPANT->NAME.FIRST = 'DAFFY') WHERE 
        FULLNAME.FIRST = 'DAFFY'

この例では、PERSON、FULLNAME、RESIDENCE のそれぞれの型に対して 1 つずつ、計 3 つの構造化型のインスタンスを生成しています。FULLNAME 属性は PERSON に組み込まれています。PERSON のインスタンスと RESIDENCE のインスタンスはテーブルの行として格納し、Ref 属性により、それぞれのインスタンスを相互に参照しています。

下に示すのは、上の SQL の構造化型に対応する Java クラスです。このようなクラスは、カタログテーブルから構造化型の定義を読み出すツールを使って生成し、マッピングツールのユーザが提供したカスタマイズ指定 (基本フィールドの名前のマッピングと型のマッピング) に従って、下のようなクラスを生成します。

注: JDBC API では、マッピングツールが必要とするメタデータにアクセスするための標準 API は提供していません。この種のメタデータを提供すると、SQL99 の型モデルで多くの複雑な依存関係の問題が生じます。このため、現在のところ保留となっています。

下のそれぞれのクラスで、SQLData.readSQL() メソッドを使って、属性を、データベース内の対応する構造化型定義で記述されている順序 (各要素の構造が、次の属性が読み出される前に再帰的に完全に読み出される「行順、深さ優先」の順序) で読み出しています。同様に、SQLData.writeSQL() でデータを同じ順序でストリームに書き込んでいます。

public class Residence implements SQLData {
    public int door;
    public String street;
    public String city;
    public Ref occupant;

    private String sql_type;
    public String getSQLTypeName() { return sql_type; }

    public void readSQL(SQLInput stream, String type) 
	throws SQLException {
      sql_type = type;
      door = stream.readInt();
      street = stream.readString();
      city = stream.readString();
      occupant = stream.readRef();
    }

    public void writeSQL(SQLOutput stream) throws SQLException {
      stream.writeInt(door);
      stream.writeString(street);
      stream.writeString(city);
      stream.writeRef(occupant);
    }
}	 

public class Fullname implements SQLData {
    public String first;
    public String last;

    private String sql_type;
    public String getSQLTypeName() { return sql_type; }

    public void readSQL(SQLInput stream, String type)
	throws SQLException {
      sql_type = type;
      first = stream.readString();
      last = stream.readString();
    }

    public void writeSQL(SQLOutput stream) throws SQLException {
      stream.writeString(first);
      stream.writeString(last);
    }
}

public class Person implements SQLData {
    Fullname name;
    float height;
    float weight;
    Ref home;

    private String sql_type;
    public String getSQLTypeName() { return sql_type; }

    public void readSQL(SQLInput stream, String type) 
	throws SQLException {
      sql_type = type;
      name = (Fullname)stream.readObject();
      height = stream.readFloat();
      weight = stream.readFloat();
      home = stream.readRef();
    }

    public void writeSQL(SQLOutput stream) 
    	throws SQLException {
      stream.writeObject(name);
      stream.writeFloat(height);
      stream.writeFloat(weight);
      stream.writeRef(home);
    }
}

次のメソッドでは、上記のクラスを使って、前に定義した HOMES テーブルと PEOPLE テーブルのデータを生成しています。

import java.sql.*;
.
.
.

public void demo (Connection con) throws SQLException {

  // setup mappings for the connection
  try {
    java.util.Map map = con.getTypeMap();
    map.put("S.RESIDENCE", Class.forName("Residence"));
    map.put("S.FULLNAME", Class.forName("Fullname"));
    map.put("S.PERSON", Class.forName("Person"));
  }
  catch (ClassNotFoundException ex) {}

  PreparedStatement pstmt;
  ResultSet rs;

  pstmt = con.prepareStatement("SELECT OCCUPANT FROM HOMES");
  rs = pstmt.executeQuery();
  rs.next();
  Ref ref = rs.getRef(1); 

  pstmt = con.prepareStatement(
            "SELECT FULLNAME FROM PEOPLE WHERE OID = ?");
  pstmt.setRef(1, ref);
  rs = pstmt.executeQuery();
  rs.next();
  Fullname who = (Fullname)rs.getObject(1);

  // prints "Daffy Duck"
  System.out.println(who.first + " " + who.last); 
}

9.4.2 Java での SQL の継承構造の表現

CREATE TYPE PERSON AS OBJECT (NAME VARCHAR(20), BIRTH DATE);

CREATE TYPE STUDENT AS OBJECT EXTENDS PERSON (GPA NUMERIC(4,2));

下の Java クラスは、上の 2 つの SQL 型を表現したものです。Student クラスは、extends 節で Person を拡張することで、上に示す SQL の型の階層を表現しています。サブクラスの SQLData.readSQL() メソッドと SQLData.writeSQL() メソッドでは、サブクラスの属性を読み出す (または書き込む) 前にスーパクラスの属性を読み出す (または書き込む) ために、それぞれそのスーパークラスの対応するメソッドを呼び出しています。

   import java.sql.*;
   ...
   public class Person implements SQLData {
     public String name;
     public Date birth;

     private String sql_type;
     public String getSQLTypeName() { return sql_type; }

     public void readSQL(SQLInput data, String type) 
	throws SQLException { 
       sql_type = type;
       name = data.readString();
       birth = data.readDate();
     }

     public void writeSQL(SQLOutput data)
     	throws SQLException { 
       data.writeString(name);
       data.writeDate(birth);
     }
   }

   public class Student extends Person {
     public float GPA;

     private String sql_type;
     public String getSQLTypeName() { return sql_type; }

     public void readSQL(SQLInput data, String type) 
	throws SQLException { 
       sql_type = type;
       super.readSQL(data, type);
       GPA = data.readFloat();
     }

     public void writeSQL(SQLOutput data)
     throws SQLException {
       super.writeSQL(data);
       data.writeFloat(GPA);
     }
   }

Java のクラス階層に SQL の継承構造を正確に反映させる必要はありません。たとえば、上の Student クラスをスーパークラスを使わずに宣言することも可能です。この場合は、SQL 型 STUDENT の継承属性を格納するフィールドと、STUDENT で宣言した属性を格納するフィールドを Student クラスに含めます。

9.4.3 SQL の弁別型を Java にマッピングする例

-- SQL definition
CREATE TYPE MONEY AS NUMERIC(10,2);  

// definition
public class Money implements SQLData { 

  public java.math.BigDecimal value;

  private String sql_type;
  public String getSQLTypeName() { return sql_type; }

  public void readSQL (SQLInput stream, String type) 
	throws SQLException {
    sql_type = type;
    value = stream.readBigDecimal();
  }

  public void writeSQL (SQLOutput stream) throws SQLException {
    stream.writeBigDecimal(value);
  }
}

9.5     カスタマイズの概略

SQL の特定の型を、条件によって Java の異なるクラスにマッピングすることもできます。これには、条件によって異なるクラスのオブジェクトを構築し、返すように SQLData.readSQL() の実装をカスタマイズします。

同様に、SQL の特定の値を Java のオブジェクトのグラフにマッピングすることもできます。この場合もやはり、SQLData.readSQL() の実装をカスタマイズして、複数のオブジェクトを構築し、構築したオブジェクトのフィールドに SQL の属性を割り当てるようにします。

SQLData.readSQL() メソッドのカスタマイズによって、型マッピングオブジェクトを段階的に生成することも可能です。 このような柔軟性により、アプリケーションの種類に応じて、SQL 型を適切にマッピングできるようになっています。

9.6     NULL データ

  void setObject (int i, Object x) throws SQLException;

型の値が null ではない場合に、対応する引数式の型が、その SQL 文に問題なく引き渡せる Java の型でなければならないという規則はありません。Java 言語の null には型の情報がありません。たとえば、AntiMatter クラスの null 変数は、対応する型マッピングオブジェクトが MATTER から AntiMatter への変換を許可していなくても、SQL 型 MATTER の値を要求する SQL 文に引数として渡すことができ、しかもエラーは発生しません。

9.7 まとめ

• 新しい SQL 型はすべて、統一的で拡張可能なインタフェースにより処理される。 このインタフェースは、JDBC API の標準となる可能性がある
  
  
• 最低限の機構だけが API に追加されている。JDBC では、SQL を表すために生成されたクラスの SQLData.readSQL() メソッドと SQLData.writeSQL() メソッドに制御を移す以上のことはしていない
  
  
• 拡張機構は、既存のインタフェース java.io.Serializable、java.io.DataInput、java.io.DataOutput、java.sql.ResultSet、および java.sql.PreparedStatement を利用している
  
  
• SQL データを表す Java クラスをカスタマイズすることで、値を追加するデータベースツールを極めて柔軟に作成できる