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)