compact3

javax.sql.rowset.serial

Class SerialArray

java.lang.Object

javax.sql.rowset.serial.SerialArray

All Implemented Interfaces:

Serializable， Cloneable， Array

public class SerialArray
extends Object
implements Array, Serializable, Cloneable

序列化版本的 Array对象，这是一个SQL ARRAY价值java编程语言的映射。

的SerialArray类提供从Array对象创建一个SerialArray实例构造函数，得到了基类型的基类型和SQL命名方法，复制的一部分或全部SerialArray对象和方法。

注：为了这类功能正确，到数据源的连接必须为SQL Array对象被物化（所有的元素带到客户端服务器）如果必要的话。此时，逻辑指向数据源中的数据，如地理位置，目前不支持。

线程安全

一serialarray不安全使用多线程并发。如果一个serialarray是用于由多个线程访问的serialarray应该通过适当的同步控制。

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
SerialArray(Array array) 构建了从给定的 Array对象的新 SerialArray对象。
SerialArray(Array array, Map<String,类<?>> map) 构建了一种新的 SerialArray对象从给定的 Array对象，使用给定的类型图为每个元素的自定义映射元素的SQL UDT。

方法摘要

Modifier and Type	Method and Description
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,类<?>> map) 返回一个新的阵列，一份一片这 SerialArray对象，从给定的索引和包含给定的连续元素个数的元素。
Object	getArray(Map<String,类<?>> map) 返回一个新的阵列，一份本 SerialArray对象，使用给定的类型图为每个元素的自定义映射元素的SQL UDT。
int	getBaseType() 在这 SerialArray检索对象的SQL类型的元素。
String	getBaseTypeName() 在这 SerialArray检索对象的元素的具体类型名称数据库。
ResultSet	getResultSet() 检索 ResultSet对象包含所有在 ARRAY价值要素，这 SerialArray对象代表。
ResultSet	getResultSet(long index, int count) 检索 ResultSet对象持有的子阵，开始在指数指数和包含了计数连续元素的元素。
ResultSet	getResultSet(long index, int count, Map<String,类<?>> map) 检索结果集控股的子阵，开始在元素检索 ResultSet对象包含子在这 SerialArray对象的元素，在指数指数起动和含有高达计数连续的元素。
ResultSet	getResultSet(Map<String,类<?>> map) 检索 ResultSet对象所包含的所有元素的值的SQL ARRAY SerialArray对象表示。
int	hashCode() 返回此serialarray哈希代码。

Methods inherited from class java.lang.Object

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

Constructor Detail

SerialArray

public SerialArray(Array array,
                   Map<String,类<?>> map)
            throws SerialException,
                   SQLException

构建了一种新的 SerialArray对象从给定的 Array对象，使用给定的类型图为每个元素的自定义映射元素的SQL UDT。

如果数组中的元素是一个UDT和给定类型的Map，UDT切入这个方法并自定义映射。自定义映射是递归的，即如果，例如，一个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对象提供此构造函数不能返回null任何Array.getArray()方法。SerialArray无法序列化空数组值。

参数

array - Array对象被序列化

map - java.util.Map对象中的每个条目包含1）一 String对象给一个UDT的完全限定名（SQL结构化类型或不同类型）和2）的 类对象实现的 SQLData如何定义UDT是映射。的Map参数没有 Blob， Clob， DATALINK任何影响，或 JAVA_OBJECT类型。

异常

SerialException -如果出现错误的 Array对象序列化

SQLException -如果一个数据库访问错误或者阵列或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对象提供此构造函数不能返回null任何Array.getArray()方法。SerialArray无法序列化null数组值。

参数

array - Array对象被序列化

异常

SerialException -如果出现错误的 Array对象序列化

SQLException -如果一个数据库访问错误发生或阵列参数 null。

方法详细信息

free

public void free()
          throws SQLException

这种方法使 SeriableArray对象并释放资源，它拥有。物体一旦 free方法是无效的。

如果free调用多次，以free随后电话被视为一个空操作。

Specified by:

free 接口 Array

异常

SQLException -如果出现错误的serialarray释放的资源

从以下版本开始：

一点六

getArray

public Object getArray()
                throws SerialException

返回一个新的阵列，一份本 SerialArray对象。

Specified by:

getArray 接口 Array

结果

这本 SerialArray对象在java编程语言的一个 Object

异常

SerialException -如果发生错误；如果 free以前被称为该对象

getArray

public Object getArray(Map<String,类<?>> map)
                throws SerialException

返回一个新的阵列，一份本 SerialArray对象，使用给定的类型图为每个元素的自定义映射元素的SQL UDT。

如果数组中的元素是一个UDT和给定类型的Map，UDT切入这个方法并自定义映射。自定义映射是递归的，即如果，例如，一个SQL结构化类型的一个元素是一个SQL结构化类型本身具有的元素，是一种结构化的类型，每个结构类型，有一个自定义的映射将被映射根据给定的类型图。

Specified by:

getArray 接口 Array

参数

map - java.util.Map对象中的每个条目包含1）一 String对象给一个UDT和2的完全合格的名称）的 类对象实现的 SQLData如何定义UDT是映射

结果

这本 SerialArray对象在java编程语言的一个 Object

异常

SerialException -如果发生错误；如果 free以前被称为该对象

getArray

public Object getArray(long index,
                       int count)
                throws SerialException

返回一个新的阵列，一份一片这 SerialArray对象，从给定的索引和包含给定的连续元素个数的元素。

Specified by:

getArray 接口 Array

参数

index -索引这个 SerialArray对象的第一个元素被复制；第一个元素的索引是 0

count -连续的元素被复制，从给定的索引

结果

一份指定元素在这 SerialArray对象在java编程语言的一个 Object

异常

SerialException -如果发生错误；如果 free以前被称为该对象

getArray

public Object getArray(long index,
                       int count,
                       Map<String,类<?>> map)
                throws SerialException

返回一个新的阵列，一份一片这 SerialArray对象，从给定的索引和包含给定的连续元素个数的元素。

如果数组中的元素是一个UDT和给定类型的Map，UDT切入这个方法并自定义映射。自定义映射是递归的，即如果，例如，一个SQL结构化类型的一个元素是一个SQL结构化类型本身具有的元素，是一种结构化的类型，每个结构类型，有一个自定义的映射将被映射根据给定的类型图。

Specified by:

getArray 接口 Array

参数

index -索引这个 SerialArray对象的第一个元素被复制；数组中第一个元素的索引 0

count -连续的元素被复制，从给定的索引

map - java.util.Map对象中的每个条目包含1）一 String对象给一个UDT和2的完全合格的名称）的 类对象实现的 SQLData如何定义UDT是映射

结果

一份指定元素在这 SerialArray对象在java编程语言的一个 Object

异常

SerialException -如果发生错误；如果 free以前被称为该对象

getBaseType

public int getBaseType()
                throws SerialException

在这 SerialArray检索对象的SQL类型的元素。 int返回的是一个在班 java.sql.Types常数。

Specified by:

getBaseType 接口 Array

结果

一个在 java.sql.Types常数，表明在这 SerialArray对象元素的SQL类型

异常

SerialException -如果发生错误；如果 free以前被称为该对象

getBaseTypeName

public String getBaseTypeName()
                       throws SerialException

在这 SerialArray检索对象的元素的具体类型名称数据库。

Specified by:

getBaseTypeName 接口 Array

结果

通过对这 SerialArray对象基类型的数据库管理系统采用SQL类型名称

异常

SerialException -如果发生错误；如果 free以前被称为该对象

getResultSet

public ResultSet getResultSet(long index,
                              int count)
                       throws SerialException

检索 ResultSet对象持有的子阵，开始在指数指数和包含了计数连续元素的元素。此方法使用连接的类型映射来映射数组的元素，如果Map中包含基本类型的条目。否则，使用标准映射。

Specified by:

getResultSet 接口 Array

参数

index -索引这个 SerialArray对象的第一个元素被复制；数组中第一个元素的索引 0

count -连续的元素被复制，从给定的索引

结果

包含指定的元素在这 SerialArray对象 ResultSet对象，每个元素与一个单独的行

异常

SerialException -如果被设置为 UnsupportedOperationException原因

getResultSet

public ResultSet getResultSet(Map<String,类<?>> map)
                       throws SerialException

检索 ResultSet对象所包含的所有元素的值的SQL ARRAY SerialArray对象表示。此方法使用指定的Map类型Map自定义除非数组的基类型不匹配用户定义类型（UDT）在Map，在这种情况下，采用标准的映射。这个版本的方法 getResultSet使用给定的类型图或标准图；它不以与连接相关的类型图。

Specified by:

getResultSet 接口 Array

参数

map - java.util.Map对象中的每个条目包含1）一 String对象给一个UDT和2的完全合格的名称）的 类对象实现的 SQLData如何定义UDT是映射

结果

一份包含所有在这 SerialArray对象的元素 ResultSet对象，每个元素与一个单独的行

异常

SerialException -如果被设置为 UnsupportedOperationException原因

getResultSet

public ResultSet getResultSet()
                       throws SerialException

检索 ResultSet对象包含所有在 ARRAY价值要素，这 SerialArray对象代表。如果适当的话，使用连接的类型映射映射数组的元素；否则，使用标准映射。

Specified by:

getResultSet 接口 Array

结果

一份包含所有在这 SerialArray对象的元素 ResultSet对象，每个元素与一个单独的行

异常

SerialException -如果被设置为 UnsupportedOperationException原因

getResultSet

public ResultSet getResultSet(long index,
                              int count,
                              Map<String,类<?>> map)
                       throws SerialException

检索结果集控股的子阵，开始在元素检索 ResultSet对象包含子在这 SerialArray对象的元素，在指数指数起动和含有高达计数连续的元素。此方法使用指定的Map类型Map自定义除非数组的基类型不匹配用户定义类型（UDT）在Map，在这种情况下，采用标准的映射。这个版本的方法 getResultSet使用给定的类型图或标准图；它不以与连接相关的类型图。

Specified by:

getResultSet 接口 Array

参数

index -索引这个 SerialArray对象的第一个元素被复制；数组中第一个元素的索引 0

count -连续的元素被复制，从给定的索引

map - java.util.Map对象中的每个条目包含1）一 String对象给一个UDT和2的完全合格的名称）的 类对象实现的 SQLData如何定义UDT是映射

结果

包含指定的元素在这 SerialArray对象 ResultSet对象，每个元素与一个单独的行

异常

SerialException -如果被设置为 UnsupportedOperationException原因

equals

public boolean equals(Object obj)

比较SerialArray到指定的对象。其结果是 true如果只有参数不 null是 SerialArray对象的元素是该对象的元素相同

重写：

equals 方法重写，继承类 Object

参数

obj的对象比较 SerialArray反对

结果

true如果给定对象代表一个 SerialArray相当于这serialarray， 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