Module java.sql.rowset

软件包 javax.sql.rowset.serial

Class SerialStruct

java.lang.Object

javax.sql.rowset.serial.SerialStruct

All Implemented Interfaces:

Serializable ， Cloneable ， Struct

public class SerialStruct
extends Object
implements Struct, Serializable, Cloneable

SQL编程语言中的SQL结构化类型的序列化映射。 尚未序列化的每个属性都映射到一个序列化的形式，如果一个属性本身是一个结构化类型，那么它的每一个尚未被序列化的属性都被映射到一个序列化的形式。

此外，如果适用，如果存在这样的映射以及其属性，则结构化类型被自定义映射到Java编程语言中的类。

SerialStruct类提供了一个用于从Struct对象创建实例的Struct函数，一种用于检索数据库中SQL结构类型的SQL类型名称的方法以及用于检索其属性值的方法。

线程安全

SerialStruct对于多个并发线程来说是不安全的。 如果一个SerialStruct被多个线程使用，则应该通过适当的同步来控制对SerialStruct的访问。

从以下版本开始：

1.5

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor	描述
SerialStruct(SQLData in, Map<String,Class<?>> map)	从给定的 SQLData对象构造一个 SerialStruct对象，使用给定的类型映射将其自定义映射到Java编程语言中的类。
SerialStruct(Struct in, Map<String,Class<?>> map)	从给定的 Struct对象构造一个 SerialStruct对象，使用给定的 java.util.Map对象自定义映射SQL结构类型或其任何属性为SQL结构类型。

方法摘要

Modifier and Type	方法	描述
Object	clone()	返回此 SerialStruct的克隆。
boolean	equals(Object obj)	将此SerialStruct与指定对象进行比较。
Object[]	getAttributes()	检索的阵列 Object包含此SQL结构类型的属性值 SerialStruct对象表示。
Object[]	getAttributes(Map<String,Class<?>> map)	检索此 SerialStruct表示为 Object值的数组的SQL结构类型的属性，如果合适，则使用给定类型映射进行自定义映射。
String	getSQLTypeName()	检索此 SerialStruct对象的SQL类型名称。
int	hashCode()	返回此 SerialStruct的哈希码。

Methods inherited from class java.lang.Object

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

构造方法详细信息

SerialStruct

public SerialStruct(Struct in,
                    Map<String,Class<?>> map)
             throws SerialException

从给定的 Struct对象构造一个 SerialStruct对象，使用给定的 java.util.Map对象自定义映射SQL结构化类型或其任何属性（即SQL结构化类型）。

参数

in -实例 Struct

map -一个 java.util.Map对象，其中每个条目包含：1）一个 String对象给出UDT的完全合格的名称和2） Class对象为 SQLData执行定义UDT是如何被映射

异常

SerialException - 如果发生错误

另请参见：

Struct

SerialStruct

public SerialStruct(SQLData in,
                    Map<String,Class<?>> map)
             throws SerialException

从给定的SQLData对象构造一个SerialStruct对象，使用给定的类型映射将其自定义映射到Java编程语言中的类。 类型映射给出了SQL类型和映射到的类。 SQLData对象定义要将SQL类型映射到的类。

参数

in - 一个 SQLData类的实例，它定义了SQL结构化类型与Java编程语言中的一个或多个对象的映射

map - 一个 java.util.Map对象，其中每个条目由1） String对象提供UDT的完全限定名称，2） SQLData实现的 Class对象，用于定义UDT如何映射

异常

SerialException - 如果发生错误

方法详细信息

getSQLTypeName

public String getSQLTypeName()
                      throws SerialException

检索此SerialStruct对象的SQL类型名称。 这是结构化类型的SQL定义中使用的名称

Specified by:

getSQLTypeName在接口 Struct

结果

一个 String对象，表示此 SerialStruct对象表示的SQL结构类型的SQL类型名称

异常

SerialException - 如果发生错误

getAttributes

public Object[] getAttributes()
                       throws SerialException

检索 Object值的数组， Object包含此 SerialStruct对象所代表的SQL结构类型的属性。

Specified by:

getAttributes在接口 Struct

结果

一个 Object数值的数组，每个元素都是这个 SerialStruct对象所代表的SQL结构化类型的属性

异常

SerialException - 如果发生错误

getAttributes

public Object[] getAttributes(Map<String,Class<?>> map)
                       throws SerialException

检索 SerialStruct表示为 Object值的数组的SQL结构类型的属性，如果合适，则使用给定的类型映射进行自定义映射。

Specified by:

getAttributes在接口 Struct

参数

map -一个 java.util.Map对象，其中每个条目包含：1）一个 String对象给出UDT的完全合格的名称和2） Class对象为 SQLData执行定义UDT是如何被映射

结果

一个 Object值的数组，每个元素都是这个 SerialStruct对象所代表的SQL结构类型的属性

异常

SerialException - 如果发生错误

equals

public boolean equals(Object obj)

将此SerialStruct与指定对象进行比较。 结果是true如果且仅当参数不是null并且是一个SerialStruct对象，其属性与此对象的属性相同

重写：

equals在 Object

参数

obj - 对比这个 SerialStruct对象

结果

true如果给定的对象表示一个 SerialStruct等效于此SerialStruct， false否则

另请参见：

Object.hashCode() ， HashMap

hashCode

public int hashCode()

返回此SerialStruct的哈希码。 使用SerialStruct对象及其SQLTypeName对象的属性的哈希码来计算SerialStruct对象的哈希码

重写：

hashCode在 Object

结果

该对象的哈希码值。

另请参见：

Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

clone

public Object clone()

返回此SerialStruct的克隆。 该副本将包含对底层attribs数组的克隆的引用，而不是对此SerialStruct对象的原始底层SerialStruct数组的SerialStruct 。

重写：

clone在 Object

结果

这个SerialStruct的一个克隆

另请参见：

Cloneable