Module  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对象也是一个逻辑指针。 因此，作为Ref对象检索SQL REF值并未实现客户端上的结构化类型的属性。

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

    如果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,Class<?>> 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)