-
- 所有已知实现类:
-
SerialRef
public interface Ref
SQL编程语言中的映射SQLREF
值,它是对数据库中SQL结构化类型值的引用。SQL
REF
值存储在一个包含可引用SQL结构类型的实例的表,并且每个REF
值是在该表中一个实例的唯一标识符。 可以使用SQLREF
值代替其引用的SQL结构化类型,作为表中的列值或结构化类型中的属性值。因为SQL
REF
值是指向SQL结构类型的逻辑指针,所以默认情况下,Ref
对象也是一个逻辑指针。 因此,作为Ref
对象检索SQLREF
值并未实现客户端上的结构化类型的属性。一个
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)
-
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)
-
-