モジュール java.sql.rowset
パッケージ javax.sql.rowset.serial

クラスSerialStruct

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オブジェクトを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    Object
    clone()
    このSerialStructのクローンを返します。
    boolean
    equals​(Object obj)
    このSerialStructを指定されたオブジェクトと比較します。
    Object[]
    getAttributes()
    このSerialStructオブジェクトによって表されるSQL構造型の属性を格納するObject値の配列を取得します。
    Object[]
    getAttributes​(Map<String,​Class<?>> map)
    指定されたカスタム・マッピング用の型マップを使って、このSerialStructによって表されるSQL構造型の属性に相当するObject値の配列を取得します(適切な場合)。
    String
    getSQLTypeName()
    このSerialStructオブジェクトのSQL型名を取得します。
    int
    hashCode()
    このSerialStructのハッシュ・コードを返します。

    クラス java.lang.Objectで宣言されたメソッド

    finalize, getClass, notify, notifyAll, toString, wait, wait, wait

  • コンストラクタの詳細

    • 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オブジェクトのベースとなる属性配列のクローンへの参照を保持するのであって、元のベースとなる属性配列への参照を保持するわけではありません。
      オーバーライド:
      clone、クラス: Object
      戻り値:
      このSerialStructのクローン
      関連項目:
      Cloneable