Module java.sql.rowset
Package javax.sql.rowset.serial

Class 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要被多个线程使用，则应通过适当的同步来控制对SerialStruct的访问。
自版本:
1.5
参见:

  • Constructor Summary

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

  • Method Summary

    Modifier and Type
    Method
    Description
    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的哈希码。

    Methods declared in class java.lang.Object

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

  • Constructor Details

    • 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)给出UDT的完全限定名称的String对象和2)定义如何将UDT映射的SQLData实现的Class对象
      抛出:
      SerialException - 如果发生错误
      参见:

    • SerialStruct

      public SerialStruct(SQLData in, Map<String,Class<?>> map) throws SerialException
      从给定的SQLData对象构造一个SerialStruct对象，使用给定的类型映射将其自定义映射到Java编程语言中的一个类。类型映射给出SQL类型以及将其映射到的类。 SQLData对象定义了SQL类型将映射到的类。
      参数:
      in - 定义SQL结构化类型映射到Java编程语言中一个或多个对象的SQLData类的实例
      map - 一个java.util.Map对象，其中每个条目包括1)给出UDT的完全限定名称的String对象和2)定义如何将UDT映射的SQLData实现的Class对象
      抛出:
      SerialException - 如果发生错误

  • Method Details

    • 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
      参见:

    • hashCode

      public int hashCode()
      返回此SerialStruct的哈希码。计算SerialStruct对象的哈希码使用SerialStruct对象及其SQLTypeName的属性的哈希码
      覆盖:
      hashCode 在类 Object中
      返回:
      此对象的哈希码值。
      参见:

    • clone

      public Object clone()
      返回此SerialStruct的克隆。副本将包含对底层属性数组的克隆的引用，而不是对此SerialStruct对象的原始底层属性数组的引用。
      覆盖:
      clone 在类 Object中
      返回:
      此SerialStruct的克隆
      参见: