SerialStruct (Java Platform SE 8)

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へのアクセスを制御するようにしてください。

関連項目:

直列化された形式

コンストラクタのサマリー

コンストラクタ
コンストラクタ	説明
`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

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスSerialStruct

スレッドの安全性

コンストラクタのサマリー

メソッドのサマリー

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

コンストラクタの詳細

SerialStruct

SerialStruct

メソッドの詳細

getSQLTypeName

getAttributes

getAttributes

equals

hashCode

clone