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