javax.sql.rowset.serial
クラス SerialRef

java.lang.Object
  javax.sql.rowset.serial.SerialRef

すべての実装されたインタフェース:

Serializable, Cloneable, Ref

public class SerialRef
extends Object
implements Ref, Serializable, Cloneable

Ref オブジェクトの直列化マッピングであり、Java プログラミング言語での SQL REF 値のマッピングです。

SerialRef クラスは、Ref オブジェクトから SerialRef インスタンスを作成するためのコンストラクタと、Ref オブジェクトを取得および設定するためのメソッドを提供します。

関連項目:

直列化された形式

コンストラクタの概要

SerialRef(Ref ref)
指定された Ref オブジェクトから SerialRef オブジェクトを構築します。

メソッドの概要

String	getBaseTypeName() Ref の基底型名を説明する文字列を返します。
Object	getObject() この SerialRef オブジェクトが参照する SQL 構造化型を表す Object を返します。
Object	getObject(Map<String,Class<?>> map) この SerialRef オブジェクトが参照する SQL 構造型を表す Object を返します。
void	setObject(Object obj) この SerialRef オブジェクトが参照する SQL 構造型を指定の Object オブジェクトに設定します。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

SerialRef

public SerialRef(Ref ref)
          throws SerialException,
                 SQLException

指定された Ref オブジェクトから SerialRef オブジェクトを構築します。

パラメータ:

ref - Ref オブジェクト。null は不可

例外:

SQLException - データベースアクセスエラーが発生した場合、ref が null の場合、または Ref オブジェクトが null 値の基底型名を返した場合

SerialException - Ref オブジェクトの直列化時にエラーが発生した場合

メソッドの詳細

getBaseTypeName

public String getBaseTypeName()
                       throws SerialException

Ref の基底型名を説明する文字列を返します。

定義:

インタフェース Ref 内の getBaseTypeName

戻り値:

Ref の基底型名を説明する文字列

例外:

SerialException - Ref オブジェクトが設定されていない場合

getObject

public Object getObject(Map<String,Class<?>> map)
                 throws SerialException

この SerialRef オブジェクトが参照する SQL 構造型を表す Object を返します。構造型の属性は、指定の型マップに従ってマッピングされます。

定義:

インタフェース Ref 内の getObject

パラメータ:

map - 0 個以上のエントリを持つ java.util.Map オブジェクト。各エントリは、(1) UDT の完全修飾名を指定する String オブジェクトと、(2) UDT のマッピング方法を定義する SQLData 実装の Class オブジェクトで構成される

戻り値:

Ref 参照によって解決され、提供された型マップに従ってマッピングされたオブジェクトインスタンス

例外:

SerialException - 参照解決でエラーが発生した場合

関連項目:

Ref.setObject(java.lang.Object)

getObject

public Object getObject()
                 throws SerialException

この SerialRef オブジェクトが参照する SQL 構造化型を表す Object を返します。

定義:

インタフェース Ref 内の getObject

戻り値:

Ref 参照から解決されたオブジェクトインスタンス

例外:

SerialException - 参照解決でエラーが発生した場合

関連項目:

Ref.setObject(java.lang.Object)

setObject

public void setObject(Object obj)
               throws SerialException

この SerialRef オブジェクトが参照する SQL 構造型を指定の Object オブジェクトに設定します。

定義:

インタフェース Ref 内の setObject

パラメータ:

obj - 参照される SQL 構造型を表す Object

例外:

SerialException - この SerialRef オブジェクトによって参照される構造型の生成時にエラーが発生した場合

関連項目:

Ref.getObject(), Ref.getObject(Map), PreparedStatement.setObject(int, Object), CallableStatement.setObject(String, Object)