模块  java.sql
软件包  java.sql

Interface Ref

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

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

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

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

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

    从以下版本开始：
    1.2
    另请参见：
    Struct

    • 方法详细信息

      • getBaseTypeName

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

      • getObject

        Object getObject​(Map<String,​类<?>> map)
          throws SQLException
        检索引用的对象，并使用给定的类型映射将其映射到Java类型。
        参数
        map - 包含要使用的映射的 java.util.Map对象（正在引用的SQL结构类型的完全限定名称以及将映射SQL结构类型的 SQLData实现的类对象）
        结果
        Java Object ，它是此 Ref对象引用的SQL结构类型的自定义映射
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始：
        1.4
        另请参见：
        setObject(java.lang.Object)

      • getObject

        Object getObject()
          throws SQLException
        检索此Ref对象引用的SQL结构类型实例。 如果连接的类型映射具有结构化类型的条目，则实例将自定义映射到类型映射中指示的Java类。 否则，结构化类型实例将映射到Struct对象。
        结果
        Java Object ，它是此 Ref对象所引用的SQL结构类型的映射
        异常
        SQLException - 如果发生数据库访问错误
        SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法
        从以下版本开始：
        1.4
        另请参见：
        setObject(java.lang.Object)