compact2, compact3

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对象不会实现客户端上的结构化类型的属性。

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

所有的方法Ref接口必须如果JDBC驱动程序支持的数据类型得到充分执行。

从以下版本开始：

1.2

另请参见：

Struct

方法摘要

Modifier and Type	Method and Description
String	getBaseTypeName() 检索此 Ref对象引用的SQL结构化类型的全限定SQL名称。
Object	getObject() 检索此 Ref对象引用的SQL结构类型实例。
Object	getObject(Map<String,类<?>> map) 检索引用的对象，并使用给定的类型映射将其映射到Java类型。
void	setObject(Object value) 设置此 Ref对象引用到给定实例 Object的结构化类型值。

方法详细信息

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结构类型和类对象的完全合格的名称为对象 SQLData执行到SQL结构类型将被映射）

结果

一个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)

setObject

void setObject(Object value)
        throws SQLException

将此Ref对象引用的结构化类型值设置为给定的Object实例。 当驱动程序将其发送到数据库时，将其转换为SQL结构类型。

参数

value -一个 Object表示SQL结构类型实例，这 Ref对象将引用

异常

SQLException - 如果发生数据库访问错误

SQLFeatureNotSupportedException - 如果JDBC驱动程序不支持此方法

从以下版本开始：

1.4

另请参见：

getObject() ， getObject(Map) ， PreparedStatement.setObject(int, Object) ， CallableStatement.setObject(String, Object)