- 所有已知的实现类:
-
SerialRef
public interface Ref
在Java编程语言中,SQL
REF
值的映射,它是对数据库中的SQL结构化类型值的引用。
SQL REF
值存储在包含可引用的SQL结构化类型实例的表中,每个 REF
值是该表中一个实例的唯一标识符。SQL REF
值可以用作表中的列值或结构化类型中的属性值的替代,它引用的SQL结构化类型。
因为SQL REF
值是对SQL结构化类型的逻辑指针,所以 Ref
对象默认也是逻辑指针。因此,将SQL REF
值作为 Ref
对象检索时,不会在客户端上实现结构化类型的属性。
可以使用 PreparedStatement.setRef
方法将 Ref
对象存储在数据库中。
如果JDBC驱动程序支持数据类型,则必须完全实现 Ref
接口上的所有方法。
- 自版本:
- 1.2
- 参见:
-
Method Summary
-
Method Details
-
getBaseTypeName
检索此Ref
对象引用的SQL结构化类型的完全限定SQL名称。- 返回:
- 引用的SQL结构化类型的完全限定SQL名称
- 抛出:
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.2
-
getObject
检索引用对象,并使用给定的类型映射将其映射到Java类型。- 参数:
-
map
- 包含要使用的映射的java.util.Map
对象(被引用的SQL结构化类型的完全限定名称和要将SQL结构化类型映射到的SQLData
实现类的类对象) - 返回:
-
作为此
Ref
对象引用的SQL结构化类型的自定义映射的JavaObject
- 抛出:
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.4
- 参见:
-
getObject
检索此Ref
对象引用的SQL结构化类型实例。如果连接的类型映射中有结构化类型的条目,则该实例将被自定义映射到类型映射中指示的Java类。否则,结构化类型实例将被映射到一个Struct
对象。- 返回:
-
作为此
Ref
对象引用的SQL结构化类型的映射的JavaObject
- 抛出:
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.4
- 参见:
-
setObject
将此Ref
对象引用的结构化类型值设置为给定的Object
实例。驱动程序在将其发送到数据库时将其转换为SQL结构化类型。- 参数:
-
value
- 表示此Ref
对象将引用的SQL结构化类型实例的Object
- 抛出:
-
SQLException
- 如果发生数据库访问错误 -
SQLFeatureNotSupportedException
- 如果JDBC驱动程序不支持此方法 - 自版本:
- 1.4
- 参见:
-