JavaTM Platform
Standard Ed. 6

java.sql
接口 Struct

所有已知实现类:
SerialStruct

public interface Struct

用于 SQL 结构化类型的 Java 编程语言中的标准映射关系。Struct 对象为它所表示的 SQL 结构化类型的每个属性包含一个值。默认情况下,只要应用程序可以引用 Struct 实例,该实例就有效。

如果 JDBC 驱动程序支持该数据类型,则必须完全实现 Struct 接口上的所有方法。

从以下版本开始:
1.2

方法摘要
 Object[] getAttributes()
          生成此 Struct 对象所表示的 SQL 结构类型属性的有序值。
 Object[] getAttributes(Map<String,Class<?>> map)
          生成此 Struct 对象所表示的 SQL 结构类型的属性的有序值。
 String getSQLTypeName()
          获取此 Struct 对象所表示 SQL 结构的完全限定的 SQL 名称。
 

方法详细信息

getSQLTypeName

String getSQLTypeName()
                      throws SQLException
获取此 Struct 对象所表示 SQL 结构的完全限定的 SQL 名称。

返回:
SQL 结构化类型的完全限定的类型名称,此 Struct 对象是该名称的一般表示形式
抛出:
SQLException - 如果发生数据库访问错误
SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
1.2

getAttributes

Object[] getAttributes()
                       throws SQLException
生成此 Struct 对象所表示的 SQL 结构类型属性的有序值。与处理每个属性一样,此方法使用与连接关联的类型映射来自定义类型映射关系。如果在连接类型映射中不存在与属性所表示的结构类型匹配的条目,则驱动程序使用标准映射关系。

从概念上讲,此方法对结构化类型的每个属性都调用 getObject 方法并返回包含结果的 Java 数组。

返回:
包含有序属性值的数组
抛出:
SQLException - 如果发生数据库访问错误
SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
1.2

getAttributes

Object[] getAttributes(Map<String,Class<?>> map)
                       throws SQLException
生成此 Struct 对象所表示的 SQL 结构类型的属性的有序值。与处理每个属性一样,此方法使用给定类型映射表来自定义类型映射关系。如果在给定类型映射表中不存在与属性所表示的结构类型匹配的条目,则驱动程序使用标准映射关系。此方法永远不使用与 connection 关联的类型映射表。

从概念上讲,此方法对结构化类型的每个属性都调用 getObject 方法并返回包含结果的 Java 数组。

参数:
map - 从 SQL 类型名称到 Java 类的映射
返回:
包含有序属性值的数组
抛出:
SQLException - 如果发生数据库访问错误
SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
从以下版本开始:
1.2

JavaTM Platform
Standard Ed. 6

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

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