java.lang.Object
javax.sql.rowset.serial.SerialStruct
- すべての実装されたインタフェース:
Serializable
,Cloneable
,Struct
public class SerialStruct extends Object implements Struct, Serializable, Cloneable
Javaプログラミング言語でのSQL構造型の直列化マッピングです。 まだ直列化されていない属性は、直列化フォームにマッピングされます。属性そのものが構造型である場合も、その属性のまだ直列化されていないものは、それぞれ直列化フォームにマッピングされます。
このようなマッピングが存在する場合、構造型は、属性と同様に、Javaプログラミング言語内のクラスにカスタム・マップされます(適切な場合)。
SerialStruct
クラスは、Struct
オブジェクトからインスタンスを作成するためのコンストラクタと、データベース内のSQL構造型のSQL型名を取得するためのメソッドと、その属性値を取得するためのメソッドを提供します。
スレッドの安全性
SerialStructは、複数の並行スレッドによる使用において安全ではありません。 複数のスレッドで使用する場合は、適切な同期処理によってSerialStructへのアクセスを制御するようにしてください。- 導入されたバージョン:
- 1.5
- 関連項目:
- 直列化された形式
-
コンストラクタのサマリー
コンストラクタコンストラクタ説明SerialStruct(SQLData in, Map<String,Class<?>> map)
指定されたSQLData
オブジェクトから、指定の型マップを使ってSerialStruct
オブジェクトを構築し、これをJavaプログラミング言語のクラスにカスタム・マップします。SerialStruct(Struct in, Map<String,Class<?>> map)
指定されたStruct
オブジェクトから、指定されたjava.util.Map
オブジェクトを使って、SQL構造型かSQL構造型の属性のいずれかのカスタム・マッピングに使用するSerialStruct
オブジェクトを構築します。 -
メソッドのサマリー
修飾子と型メソッド説明clone()
このSerialStruct
のクローンを返します。boolean
このSerialStructを指定されたオブジェクトと比較します。Object[]
このSerialStruct
オブジェクトによって表されるSQL構造型の属性を格納するObject
値の配列を取得します。Object[]
getAttributes(Map<String,Class<?>> map)
指定されたカスタム・マッピング用の型マップを使って、このSerialStruct
によって表されるSQL構造型の属性に相当するObject
値の配列を取得します(適切な場合)。このSerialStruct
オブジェクトのSQL型名を取得します。int
hashCode()
このSerialStruct
のハッシュ・コードを返します。
-
コンストラクタの詳細
-
SerialStruct
public SerialStruct(Struct in, Map<String,Class<?>> map) throws SerialException指定されたStruct
オブジェクトから、指定されたjava.util.Map
オブジェクトを使って、SQL構造型かSQL構造型の属性のいずれかのカスタム・マッピングに使用するSerialStruct
オブジェクトを構築します。- パラメータ:
in
-Struct
のインスタンスmap
-java.util.Map
オブジェクト。オブジェクト内の各エントリは、(1) UDTの完全修飾名を指定するString
オブジェクトと、(2) UDTのマッピング方法を定義するSQLData
実装のClass
オブジェクトで構成される- 例外:
SerialException
- エラーが発生した場合- 関連項目:
Struct
-
SerialStruct
public SerialStruct(SQLData in, Map<String,Class<?>> map) throws SerialException指定されたSQLData
オブジェクトから、指定の型マップを使ってSerialStruct
オブジェクトを構築し、これをJavaプログラミング言語のクラスにカスタム・マップします。 型マップは、SQL型とマップ先のクラスを指定します。SQLData
オブジェクトは、SQL型のマップ先のクラスを定義します。- パラメータ:
in
- SQL構造型とJavaプログラミング言語の1個以上のオブジェクトのマッピングを定義するSQLData
クラスのインスタンスmap
-java.util.Map
オブジェクト。オブジェクト内の各エントリは、(1) UDTの完全修飾名を指定するString
オブジェクトと、(2) UDTのマッピング方法を定義するSQLData
実装のClass
オブジェクトで構成される- 例外:
SerialException
- エラーが発生した場合
-
-
メソッドの詳細
-
getSQLTypeName
public String getSQLTypeName() throws SerialExceptionこのSerialStruct
オブジェクトのSQL型名を取得します。 これは、構造型のSQL定義で使用される名前に一致します。- 定義:
getSQLTypeName
、インタフェース:Struct
- 戻り値:
- この
SerialStruct
オブジェクトによって表されるSQL構造型のSQL型名を表すString
オブジェクト - 例外:
SerialException
- エラーが発生した場合
-
getAttributes
public Object[] getAttributes() throws SerialExceptionこのSerialStruct
オブジェクトによって表されるSQL構造型の属性を格納するObject
値の配列を取得します。- 定義:
getAttributes
、インタフェース:Struct
- 戻り値:
Object
値の配列。このSerialStruct
オブジェクトによって表されるSQL構造型の属性を要素として格納する- 例外:
SerialException
- エラーが発生した場合
-
getAttributes
public Object[] getAttributes(Map<String,Class<?>> map) throws SerialException指定されたカスタム・マッピング用の型マップを使って、このSerialStruct
によって表されるSQL構造型の属性に相当するObject
値の配列を取得します(適切な場合)。- 定義:
getAttributes
、インタフェース:Struct
- パラメータ:
map
-java.util.Map
オブジェクト。オブジェクト内の各エントリは、(1) UDTの完全修飾名を指定するString
オブジェクトと、(2) UDTのマッピング方法を定義するSQLData
実装のClass
オブジェクトで構成される- 戻り値:
Object
値の配列。このSerialStruct
オブジェクトによって表されるSQL構造型の属性を要素として格納する- 例外:
SerialException
- エラーが発生した場合
-
equals
public boolean equals(Object obj)このSerialStructを指定されたオブジェクトと比較します。 引数がnull
でなく、このオブジェクトと同じ属性を持つSerialStruct
オブジェクトである場合にのみ、結果はtrue
になります- オーバーライド:
equals
、クラス:Object
- パラメータ:
obj
- このSerialStruct
と比較するオブジェクト- 戻り値:
- 指定されたオブジェクトがこのSerialStructに等しい
SerialStruct
を表す場合はtrue
、それ以外の場合はfalse
- 関連項目:
Object.hashCode()
、HashMap
-
hashCode
public int hashCode()このSerialStruct
のハッシュ・コードを返します。SerialStruct
オブジェクトのハッシュ・コードは、SerialStruct
オブジェクトの属性とそのSQLTypeName
のハッシュ・コードを使用して計算されます。- オーバーライド:
hashCode
、クラス:Object
- 戻り値:
- このオブジェクトのハッシュ・コード値。
- 関連項目:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
clone
public Object clone()このSerialStruct
のクローンを返します。 コピーは、このSerialStruct
オブジェクトのベースとなる属性配列のクローンへの参照を保持するのであって、元のベースとなる属性配列への参照を保持するわけではありません。
-