compact2, compact3

java.sql

Interface Ref

所有已知实现类：

SerialRef

public interface Ref

在一个SQL REF价值java编程语言的映射，这是一个结构化的数据库中的值类型。

SQL REF值存储在一个表中包含一个可参考SQL结构化类型的实例，每个REF值唯一标识表中的一个实例。一个SQL REF值可用于SQL结构化类型引用的地方，无论是作为一个结构类型表中的列值或属性值。

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

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

在Ref接口的所有方法都必须完全执行如果JDBC驱动程序支持的数据类型。

从以下版本开始：

一点二

另请参见：

Struct

方法摘要

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

方法详细信息

getBaseTypeName

String getBaseTypeName()
                throws SQLException

完全限定名称检索SQL SQL结构化类型，这 Ref对象引用。

结果

完全限定名引用SQL SQL结构化类型

异常

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

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

从以下版本开始：

一点二

getObject

Object getObject(Map<String,类<?>> map)
          throws SQLException

检索到使用给定的类型图java类型的引用对象映射。

参数

map - java.util.Map对象包含要使用的映射（完全限定名的SQL结构化类型引用和类对象的 SQLData执行SQL结构化类型将映射）

结果

一个java Object这是自定义映射为SQL结构化类型，这 Ref对象引用

异常

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

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

从以下版本开始：

一点四

另请参见：

setObject(java.lang.Object)

getObject

Object getObject()
          throws SQLException

检索SQL结构化类型的实例的 Ref对象引用。如果连接的类型图为结构化类型的实例的一个条目，将在Map上显示自定义类型映射到java类。否则，结构化类型的实例将被映射到一个 Struct对象。

结果

一个java Object即映射为SQL结构化类型，这 Ref对象引用

异常

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

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

从以下版本开始：

一点四

另请参见：

setObject(java.lang.Object)

setObject

void setObject(Object value)
        throws SQLException

设置结构化类型值，这 Ref对象引用的实例 Object。司机将一个SQL结构化类型时，它发送到数据库。

参数

value - Object代表SQL结构化类型的实例，这 Ref对象参考

异常

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

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

从以下版本开始：

一点四

另请参见：

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