模块 java.sql
包 java.sql

接口 Ref

所有已知的实现类：
SerialRef
public interface Ref
SQL REF 值在 Java 编程语言中的映射，它是对数据库中 SQL 结构化类型值的引用。

SQL REF 值存储在包含可引用 SQL 结构类型实例的表中，每个 REF 值都是该表中一个实例的唯一标识符。 SQL REF 值可用于代替它引用的 SQL 结构化类型，作为表中的列值或结构化类型中的属性值。

因为 SQL REF 值是指向 SQL 结构类型的逻辑指针，所以默认情况下 Ref 对象也是逻辑指针。因此，将 SQL REF 值检索为 Ref 对象不会在客户端实现结构化类型的属性。

可以使用 PreparedStatement.setRef 方法将 Ref 对象存储在数据库中。

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

自从：
1.2
参见：

  • 方法总结

    修饰符和类型
    方法
    描述
    String
    getBaseTypeName()
    检索此 Ref 对象引用的 SQL 结构类型的完全限定 SQL 名称。
    Object
    getObject()
    检索此 Ref 对象引用的 SQL 结构化类型实例。
    Object
    getObject(Map<String,Class<?>> map)
    检索引用的对象并使用给定的类型映射将其映射到 Java 类型。
    void
    setObject(Object value)
    将此 Ref 对象引用的结构化类型值设置为 Object 的给定实例。

  • 方法详情

    • getBaseTypeName

      String  getBaseTypeName() throws SQL异常
      检索此 Ref 对象引用的 SQL 结构类型的完全限定 SQL 名称。
      返回：
      引用的 SQL 结构类型的完全限定 SQL 名称
      抛出：
      SQLException - 如果发生数据库访问错误
      SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
      自从：
      1.2

    • getObject

      Object  getObject(Map <String ,Class <?>> map) throws SQL异常
      检索引用的对象并使用给定的类型映射将其映射到 Java 类型。
      参数：
      map - 包含要使用的映射的 java.util.Map 对象（被引用的 SQL 结构类型的完全限定名称和 SQL 结构类型将映射到的 SQLData 实现的类对象）
      返回：
      一个 Java Object，它是此 Ref 对象引用的 SQL 结构类型的自定义映射
      抛出：
      SQLException - 如果发生数据库访问错误
      SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
      自从：
      1.4
      参见：

    • getObject

      Object  getObject() throws SQL异常
      检索此 Ref 对象引用的 SQL 结构化类型实例。如果连接的类型映射具有结构化类型的条目，则实例将自定义映射到类型map中指示的 Java 类。否则，结构化类型实例将映射到 Struct 对象。
      返回：
      一个 Java Object，它是此 Ref 对象引用的 SQL 结构类型的映射
      抛出：
      SQLException - 如果发生数据库访问错误
      SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
      自从：
      1.4
      参见：

    • setObject

      void setObject(Object  value) throws SQL异常
      将此 Ref 对象引用的结构化类型值设置为 Object 的给定实例。驱动程序在将其发送到数据库时将其转换为 SQL 结构化类型。
      参数：
      value - 一个 Object 表示此 Ref 对象将引用的 SQL 结构化类型实例
      抛出：
      SQLException - 如果发生数据库访问错误
      SQLFeatureNotSupportedException - 如果 JDBC 驱动程序不支持此方法
      自从：
      1.4
      参见：