SerialArray (Java Platform SE 8)

java.lang.Object
- javax.sql.rowset.serial.SerialArray

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

Serializable、Cloneable、Array
```
public class SerialArray
extends Object
implements Array, Serializable, Cloneable
```
Arrayオブジェクトの直列化バージョンであり、Javaプログラミング言語でのSQL ARRAY値のマッピングです。
SerialArrayクラスは、ArrayオブジェクトからSerialArrayインスタンスを作成するためのコンストラクタと、基底型とそのSQL名を取得するためのメソッドと、SerialArrayオブジェクトの一部または全部をコピーするためのメソッドを提供します。
ノート: このクラスを正常に動作させるためには、必要に応じてSQL Arrayオブジェクトを生成する(そのすべての要素をクライアント・サーバーに移動させる)ためにデータ・ソース接続が利用可能である必要があります。現時点では、ロケータなどのデータ・ソースのデータへの論理ポインタはサポートされていません。
スレッドの安全性
SerialArrayは、複数の並行スレッドによる使用において安全ではありません。複数のスレッドで使用する場合は、適切な同期処理によってSerialArrayへのアクセスを制御するようにしてください。

関連項目:

直列化された形式

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

コンストラクタ
コンストラクタ	説明
`SerialArray(Array array)`	指定された`Array`オブジェクトから新しい`SerialArray`オブジェクトを構築します。
`SerialArray(Array array, Map<String,Class<?>> map)`	要素がSQL UDTであるとき、各要素のカスタム・マッピングに使用される指定の型マップを使って、指定された`Array`オブジェクトから新しい`SerialArray`オブジェクトを構築します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`Object`	`clone()`	この`SerialArray`のクローンを返します。
`boolean`	`equals(Object obj)`	このSerialArrayを指定されたオブジェクトと比較します。
`void`	`free()`	このメソッドは、`SeriableArray`オブジェクトを解放して、保持されているリソースを解放します。
`Object`	`getArray()`	この`SerialArray`オブジェクトのコピーである新しい配列を返します。
`Object`	`getArray(long index, int count)`	この`SerialArray`オブジェクトのスライスのコピーとなる新しい配列(指定されたインデックス位置の要素から指定の要素数分続く)を返します。
`Object`	`getArray(long index, int count, Map<String,Class<?>> map)`	この`SerialArray`オブジェクトのスライスのコピーとなる新しい配列(指定されたインデックス位置の要素から指定の要素数分続く)を返します。
`Object`	`getArray(Map<String,Class<?>> map)`	要素がSQL UDTであるとき、各要素のカスタム・マッピングに使用される指定の型マップを使って、この`SerialArray`オブジェクトのコピーである新しい配列を返します。
`int`	`getBaseType()`	この`SerialArray`オブジェクト内の要素のSQL型を取得します。
`String`	`getBaseTypeName()`	この`SerialArray`オブジェクト内に格納された要素のDBMS固有の型名を取得します。
`ResultSet`	`getResultSet()`	この`SerialArray`オブジェクトによって表現する`ARRAY`値のすべての要素が格納されている`ResultSet`オブジェクトを取得します。
`ResultSet`	`getResultSet(long index, int count)`	インデックスindexで始まり、最大でcount個の連続した部分配列の要素が格納されている`ResultSet`オブジェクトを取得します。
`ResultSet`	`getResultSet(long index, int count, Map<String,Class<?>> map)`	インデックスindexで始まり、最大でcount個の連続した要素を格納する`SerialArray`オブジェクトの要素の部分配列を格納する`ResultSet`オブジェクトを取得します。
`ResultSet`	`getResultSet(Map<String,Class<?>> map)`	この`SerialArray`オブジェクトによって表現されたSQL `ARRAY`値のすべての要素を含む`ResultSet`オブジェクトを取得します。
`int`	`hashCode()`	このSerialArrayのハッシュ・コードを返します。

クラス java.lang.Objectから継承されたメソッド
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - SerialArray
```
public SerialArray(Array array,
                   Map<String,Class<?>> map)
            throws SerialException,
                   SQLException
```
    要素がSQL UDTであるとき、各要素のカスタム・マッピングに使用される指定の型マップを使って、指定されたArrayオブジェクトから新しいSerialArrayオブジェクトを構築します。
    このメソッドは、配列要素がUDTで、指定された型マップにUDTのエントリがある場合に、カスタム・マッピングを行います。カスタム・マッピングは再帰的です。たとえば、SQL構造型のある要素が、それ自体SQL構造型の要素を持つSQL構造型である場合、カスタム・マッピングを持つ各構造型が、指定の型マップに従ってマップされます。
    新しいSerialArrayオブジェクトは、その構築に使用されるArrayオブジェクトと同じ要素を格納します。ただし、基底型がSQL型のSTRUCT、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECTである場合を除きます。この場合、新しいSerialArrayオブジェクト内の各要素は、適切な直列化フォーム、すなわちSerialStruct、SerialArray、SerialBlob、SerialClob、SerialDatalink、SerialJavaObjectのいずれかのオブジェクトになります。
    ノート: (1) SerialArrayオブジェクトの作成に使用されるArrayオブジェクトは、コンストラクタに渡される前に、クライアントにSQL ARRAY値のデータを渡していなければいけません。そうしないと、新しいSerialArrayオブジェクトはデータを持たないオブジェクトになります。
    ノート: (2) Arrayにjava.sql.Types.JAVA_OBJECT型が格納されている場合、SerialJavaObjectコンストラクタが呼び出され、このオブジェクトが直列化可能であることが確認されます。
    ノート: (3)このコンストラクタに指定されたArrayオブジェクトは、Array.getArray()メソッドに対してnullを返すことはできません。 SerialArrayはnull配列値を直列化できません。
    
    パラメータ:
    
    array - 直列化されるArrayオブジェクト
    
    map - java.util.Mapオブジェクト。オブジェクト内の各エントリは、(1) UDT (SQL構造化型またはSQL DISTINCT型)の完全修飾名を指定するStringオブジェクトと、(2) UDTのマッピング方法を定義するSQLData実装のClassオブジェクトで構成される。 mapパラメータは、Blob、Clob、DATALINKまたはJAVA_OBJECT型に対しては無効。
    
    例外:
    
    SerialException - Arrayオブジェクトの直列化時にエラーが発生した場合
    
    SQLException - データベース・アクセス・エラーが発生した場合、またはarrayかmapの値がnullの場合
  - SerialArray
```
public SerialArray(Array array)
            throws SerialException,
                   SQLException
```
    指定されたArrayオブジェクトから新しいSerialArrayオブジェクトを構築します。
    このコンストラクタは、カスタム・マッピングを行いません。配列の基底型がSQL構造型であり、カスタム・マッピングが必要な場合は、コンストラクタSerialArray(Array array, Map map)を使用する必要があります。
    新しいSerialArrayオブジェクトは、その構築に使用されるArrayオブジェクトと同じ要素を格納します。ただし、基底型がSQL型のBLOB、CLOB、DATALINK、JAVA_OBJECTである場合を除きます。この場合、新しいSerialArrayオブジェクト内の各要素は、適切な直列化フォーム、すなわちSerialBlob、SerialClob、SerialDatalink、SerialJavaObjectのいずれかのオブジェクトになります。
    ノート: (1) SerialArrayオブジェクトの作成に使用されるArrayオブジェクトは、コンストラクタに渡される前に、クライアントにSQL ARRAY値のデータを渡していなければいけません。そうしないと、新しいSerialArrayオブジェクトはデータを持たないオブジェクトになります。
    ノート: (2)このコンストラクタに指定されたArrayオブジェクトは、Array.getArray()メソッドに対してnullを返すことはできません。 SerialArrayはnull配列値を直列化できません。
    
    パラメータ:
    
    array - 直列化されるArrayオブジェクト
    
    例外:
    
    SerialException - Arrayオブジェクトの直列化時にエラーが発生した場合
    
    SQLException - データベース・アクセス・エラーが発生した場合、またはarrayパラメータがnullの場合。
- メソッドの詳細
  - free
```
public void free()
          throws SQLException
```
    このメソッドは、SeriableArrayオブジェクトを解放して、保持されているリソースを解放します。 freeメソッドが一度呼び出されたあとは、オブジェクトは無効になります。
    freeを複数回呼び出した場合、2回目以降のfree呼出しは何も行わないものとして扱われます。
    
    定義:
    
    free、インタフェースArray
    
    例外:
    
    SQLException - SerialArrayのリソースの解放時にエラーが発生した場合
    
    導入されたバージョン:
    
    1.6
  - getArray
```
public Object getArray()
                throws SerialException
```
    このSerialArrayオブジェクトのコピーである新しい配列を返します。
    
    定義:
    
    getArray、インタフェースArray
    
    戻り値:
    
    このSerialArrayオブジェクトのコピーに相当する、Javaプログラミング言語でのObject
    
    例外:
    
    SerialException - エラーが発生した場合、またはこのオブジェクトでfreeが以前呼び出された場合
  - getArray
```
public Object getArray(Map<String,Class<?>> map)
                throws SerialException
```
    要素がSQL UDTであるとき、各要素のカスタム・マッピングに使用される指定の型マップを使って、このSerialArrayオブジェクトのコピーである新しい配列を返します。
    このメソッドは、配列要素がUDTで、指定された型マップにUDTのエントリがある場合に、カスタム・マッピングを行います。カスタム・マッピングは再帰的です。たとえば、SQL構造型のある要素が、それ自体SQL構造型の要素を持つSQL構造型である場合、カスタム・マッピングを持つ各構造型が、指定の型マップに従ってマップされます。
    
    定義:
    
    getArray、インタフェースArray
    
    パラメータ:
    
    map - java.util.Mapオブジェクト。オブジェクト内の各エントリは、(1) UDTの完全修飾名を指定するStringオブジェクトと、(2) UDTのマッピング方法を定義するSQLData実装のClassオブジェクトで構成される
    
    戻り値:
    
    このSerialArrayオブジェクトのコピーに相当する、Javaプログラミング言語でのObject
    
    例外:
    
    SerialException - エラーが発生した場合、またはこのオブジェクトでfreeが以前呼び出された場合
  - getArray
```
public Object getArray(long index,
                       int count)
                throws SerialException
```
    このSerialArrayオブジェクトのスライスのコピーとなる新しい配列(指定されたインデックス位置の要素から指定の要素数分続く)を返します。
    
    定義:
    
    getArray、インタフェースArray
    
    パラメータ:
    
    index - このSerialArrayオブジェクト内で、最初の要素がコピーされる位置を表すインデックス。最初の要素のインデックスは0
    
    count - コピーされる連続した要素数。指定されたインデックス位置から開始される
    
    戻り値:
    
    このSerialArrayオブジェクト内の指定された要素のコピーに相当する、Javaプログラミング言語でのObject
    
    例外:
    
    SerialException - エラーが発生した場合、またはこのオブジェクトでfreeが以前呼び出された場合
  - getArray
```
public Object getArray(long index,
                       int count,
                       Map<String,Class<?>> map)
                throws SerialException
```
    このSerialArrayオブジェクトのスライスのコピーとなる新しい配列(指定されたインデックス位置の要素から指定の要素数分続く)を返します。
    このメソッドは、配列要素がUDTで、指定された型マップにUDTのエントリがある場合に、カスタム・マッピングを行います。カスタム・マッピングは再帰的です。たとえば、SQL構造型のある要素が、それ自体SQL構造型の要素を持つSQL構造型である場合、カスタム・マッピングを持つ各構造型が、指定の型マップに従ってマップされます。
    
    定義:
    
    getArray、インタフェースArray
    
    パラメータ:
    
    index - このSerialArrayオブジェクト内で、最初の要素がコピーされる位置を表すインデックス。配列内の最初の要素のインデックスは0
    
    count - コピーされる連続した要素数。指定されたインデックス位置から開始される
    
    map - java.util.Mapオブジェクト。オブジェクト内の各エントリは、(1) UDTの完全修飾名を指定するStringオブジェクトと、(2) UDTのマッピング方法を定義するSQLData実装のClassオブジェクトで構成される
    
    戻り値:
    
    このSerialArrayオブジェクト内の指定された要素のコピーに相当する、Javaプログラミング言語でのObject
    
    例外:
    
    SerialException - エラーが発生した場合、またはこのオブジェクトでfreeが以前呼び出された場合
  - getBaseType
```
public int getBaseType()
                throws SerialException
```
    このSerialArrayオブジェクト内の要素のSQL型を取得します。返されるintは、java.sql.Typesクラスの定数の1つです。
    
    定義:
    
    getBaseType、インタフェースArray
    
    戻り値:
    
    java.sql.Types内の定数の1つ。このSerialArrayオブジェクト内の要素のSQL型を表す
    
    例外:
    
    SerialException - エラーが発生した場合、またはこのオブジェクトでfreeが以前呼び出された場合
  - getBaseTypeName
```
public String getBaseTypeName()
                       throws SerialException
```
    このSerialArrayオブジェクト内に格納された要素のDBMS固有の型名を取得します。
    
    定義:
    
    getBaseTypeName、インタフェースArray
    
    戻り値:
    
    このSerialArrayオブジェクトの基底型の、DBMSによって使用されるSQL型名
    
    例外:
    
    SerialException - エラーが発生した場合、またはこのオブジェクトでfreeが以前呼び出された場合
  - getResultSet
```
public ResultSet getResultSet(long index,
                              int count)
                       throws SerialException
```
    インデックスindexで始まり、最大でcount個の連続した部分配列の要素が格納されているResultSetオブジェクトを取得します。マップに基底型のエントリが格納されている場合、このメソッドは接続の型マップを使って配列の要素をマッピングします。そうでない場合は、標準のマップが使われます。
    
    定義:
    
    getResultSet、インタフェースArray
    
    パラメータ:
    
    index - このSerialArrayオブジェクト内で、最初の要素がコピーされる位置を表すインデックス。配列内の最初の要素のインデックスは0
    
    count - コピーされる連続した要素数。指定されたインデックス位置から開始される
    
    戻り値:
    
    このSerialArrayオブジェクト内の指定の要素を格納するResultSetオブジェクト。各要素は別々の行に示される
    
    例外:
    
    SerialException - 原因がUnsupportedOperationExceptionに設定された状態で呼び出された場合
  - getResultSet
```
public ResultSet getResultSet(Map<String,Class<?>> map)
                       throws SerialException
```
    このSerialArrayオブジェクトによって表現されたSQL ARRAY値のすべての要素を含むResultSetオブジェクトを取得します。このメソッドは、指定されたmapを型マップのカスタマイズに使用します。ただし配列の基底型がmapのユーザー定義型(UDT)と一致しない場合は、かわりに標準のマップが使用されます。このバージョンのgetResultSetメソッドは、指定された型マップか、標準マップのどちらかを使用します。接続に関連した型マップは使われません。
    
    定義:
    
    getResultSet、インタフェースArray
    
    パラメータ:
    
    map - java.util.Mapオブジェクト。オブジェクト内の各エントリは、(1) UDTの完全修飾名を指定するStringオブジェクトと、(2) UDTのマッピング方法を定義するSQLData実装のClassオブジェクトで構成される
    
    戻り値:
    
    このSerialArrayオブジェクト内のすべての要素を格納するResultSetオブジェクト。各要素は別々の行に示される
    
    例外:
    
    SerialException - 原因がUnsupportedOperationExceptionに設定された状態で呼び出された場合
  - getResultSet
```
public ResultSet getResultSet()
                       throws SerialException
```
    このSerialArrayオブジェクトによって表現するARRAY値のすべての要素が格納されているResultSetオブジェクトを取得します。該当する場合は、配列の要素が接続の型マップを使用してマッピングされます。そうでない場合は、標準のマップが使用されます。
    
    定義:
    
    getResultSet、インタフェースArray
    
    戻り値:
    
    このSerialArrayオブジェクト内のすべての要素を格納するResultSetオブジェクト。各要素は別々の行に示される
    
    例外:
    
    SerialException - 原因がUnsupportedOperationExceptionに設定された状態で呼び出された場合
  - getResultSet
```
public ResultSet getResultSet(long index,
                              int count,
                              Map<String,Class<?>> map)
                       throws SerialException
```
    インデックスindexで始まり、最大でcount個の連続した要素を格納するSerialArrayオブジェクトの要素の部分配列を格納するResultSetオブジェクトを取得します。このメソッドは、指定されたmapを型マップのカスタマイズに使用します。ただし配列の基底型がmapのユーザー定義型(UDT)と一致しない場合は、かわりに標準のマップが使用されます。このバージョンのgetResultSetメソッドは、指定された型マップか、標準マップのどちらかを使用します。接続に関連した型マップは使われません。
    
    定義:
    
    getResultSet、インタフェースArray
    
    パラメータ:
    
    index - このSerialArrayオブジェクト内で、最初の要素がコピーされる位置を表すインデックス。配列内の最初の要素のインデックスは0
    
    count - コピーされる連続した要素数。指定されたインデックス位置から開始される
    
    map - java.util.Mapオブジェクト。オブジェクト内の各エントリは、(1) UDTの完全修飾名を指定するStringオブジェクトと、(2) UDTのマッピング方法を定義するSQLData実装のClassオブジェクトで構成される
    
    戻り値:
    
    このSerialArrayオブジェクト内の指定の要素を格納するResultSetオブジェクト。各要素は別々の行に示される
    
    例外:
    
    SerialException - 原因がUnsupportedOperationExceptionに設定された状態で呼び出された場合
  - equals
```
public boolean equals(Object obj)
```
    このSerialArrayを指定されたオブジェクトと比較します。引数がnullでなく、このオブジェクトと同じ要素を持つSerialArrayオブジェクトである場合にのみ、結果はtrueになります
    
    オーバーライド:
    
    equals、クラスObject
    
    パラメータ:
    
    obj - このSerialArrayと比較するオブジェクト
    
    戻り値:
    
    指定されたオブジェクトがこのSerialArrayに等しいSerialArrayを表す場合はtrue、それ以外の場合はfalse
    
    関連項目:
    
    Object.hashCode(), HashMap
  - hashCode
```
public int hashCode()
```
    このSerialArrayのハッシュ・コードを返します。 SerialArrayオブジェクトのハッシュ・コードは、SerialArrayオブジェクトの各要素のハッシュ・コードを使用して計算されます。
    
    オーバーライド:
    
    hashCode、クラスObject
    
    戻り値:
    
    このオブジェクトのハッシュ・コード値
    
    関連項目:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - clone
```
public Object clone()
```
    このSerialArrayのクローンを返します。コピーは、このSerialArrayオブジェクトのベースとなるオブジェクト配列のクローンへの参照を保持するのであって、元のベースとなるオブジェクト配列への参照を保持するわけではありません。
    
    オーバーライド:
    
    clone、クラスObject
    
    戻り値:
    
    このSerialArrayのクローン
    
    関連項目:
    
    Cloneable

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

クラスSerialArray

スレッドの安全性

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

メソッドのサマリー

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

コンストラクタの詳細

SerialArray

SerialArray

メソッドの詳細

free

getArray

getArray

getArray

getArray

getBaseType

getBaseTypeName

getResultSet

getResultSet

getResultSet

getResultSet

equals

hashCode

clone