JavaTM 2 Platform
Standard Ed. 5.0

javax.sql.rowset.serial
类 SerialStruct

java.lang.Object
  继承者 javax.sql.rowset.serial.SerialStruct
所有已实现的接口:
Serializable, Cloneable, Struct

public class SerialStruct
extends Object
implements Struct, Serializable, Cloneable

SQL 结构类型在 Java 编程语言中的序列化映射关系。每个尚未序列化的属性将被映射为序列化形式;如果属性本身是结构类型,则其每个尚未序列化的属性将被映射为序列化形式。

此外,结构类型将被映射为 Java 编程语言中的类,如果存在这样的映射关系;如果存在适用于其属性的映射关系,则其属性也会被映射。

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

另请参见:
序列化表格

构造方法摘要
SerialStruct(SQLData in, Map<String,Class<?>> map)
          根据给定 SQLData 对象构造 SerialStruct 对象,使用给定类型映射表将其自定义映射为 Java 编程语言中的类。
SerialStruct(Struct in, Map<String,Class<?>> map)
          根据给定 Struct 对象构造 SerialStruct 对象,使用给定 java.util.Map 对象来自定义映射 SQL 结构类型或其任何为 SQL 结构类型的属性。
 
方法摘要
 Object[] getAttributes()
          检索 Object 值的数组,该数组包含此 SerialStruct 对象所表示的 SQL 结构类型的属性。
 Object[] getAttributes(Map<String,Class<?>> map)
          检索此 SerialStruct 表示为 Object 值数组的 SQL 结构类型的属性;如果适用,则使用给定的类型映射表进行自定义映射。
 String getSQLTypeName()
          检索此 SerialStruct 对象的 SQL 类型名称。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

SerialStruct

public SerialStruct(Struct in,
                    Map<String,Class<?>> map)
             throws SerialException
根据给定 Struct 对象构造 SerialStruct 对象,使用给定 java.util.Map 对象来自定义映射 SQL 结构类型或其任何为 SQL 结构类型的属性。

参数:
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 - SQLData 类的实例,该类将 SQL 结构类型的映射关系定义为 Java 编程语言中的一个或多个对象
map - java.util.Map 对象,其中每个条目包含:1) 给出 UDT 完全限定名的 String 对象 2) 用于定义 UDT 映射方式的 SQLData 实现的 Class 对象
抛出:
SerialException - 如果发生错误
方法详细信息

getSQLTypeName

public String getSQLTypeName()
                      throws SerialException
检索此 SerialStruct 对象的 SQL 类型名称。此为在结构类型的 SQL 定义中使用的名称。

指定者:
接口 Struct 中的 getSQLTypeName
返回:
String 对象,该对象表示此 SerialStruct 对象所表示的 SQL 结构类型的 SQL 类型名称
抛出:
SerialException - 如果发生错误

getAttributes

public Object[] getAttributes()
                       throws SerialException
检索 Object 值的数组,该数组包含此 SerialStruct 对象所表示的 SQL 结构类型的属性。

指定者:
接口 Struct 中的 getAttributes
返回:
Object 值的数组,其中每个元素为此 SerialStruct 对象所表示的 SQL 结构类型的属性。
抛出:
SerialException - 如果发生错误

getAttributes

public Object[] getAttributes(Map<String,Class<?>> map)
                       throws SerialException
检索此 SerialStruct 表示为 Object 值数组的 SQL 结构类型的属性;如果适用,则使用给定的类型映射表进行自定义映射。

指定者:
接口 Struct 中的 getAttributes
参数:
map - java.util.Map 对象,其中每个条目包含:1) 给出 UDT 完全限定名的 String 对象 2) 用于定义 UDT 映射方式的 SQLData 实现的 Class 对象
返回:
Object 值数组,其中每个元素都是此 SerialStruct 对象所表示的 SQL 结构类型的属性
抛出:
SerialException - 如果发生错误

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策