java.sql

接口
异常
所有已知实现类:
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