模块  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)