public interface Ref
java.sql.Ref |
SQL编程语言中的SQL REF
值的映射,它是对数据库中SQL结构化类型值的引用。
SQL REF
值存储在包含可引用SQL结构类型实例的表中,每个REF
值都是该表中一个实例的唯一标识符。 可以使用SQL REF
来代替它引用的SQL结构类型,可以是表中的列值,也可以是结构化类型中的属性值。
由于SQL REF
值是指向SQL结构类型的逻辑指针,因此默认情况下Ref
对象也是逻辑指针。 因此,将SQL REF
值作为Ref
对象检索不会实现客户端上结构化类型的属性。
可以使用 PreparedStatement.setRef
方法将 Ref
对象存储在数据库中。
如果JDBC驱动程序支持数据类型,则必须完全实现 Ref
接口上的所有方法。
也可以看看:
Public methods |
|
---|---|
abstract String |
getBaseTypeName() 检索此 |
abstract Object |
getObject() 检索此 |
abstract Object |
getObject(Map<String, Class<?>> map) 检索引用的对象并使用给定的类型映射将其映射到Java类型。 |
abstract void |
setObject(Object value) 设置此 |
String getBaseTypeName ()
检索此 Ref
对象引用的SQL结构化类型的标准SQL名称。
Returns | |
---|---|
String |
the fully-qualified SQL name of the referenced SQL structured type |
Throws | |
---|---|
SQLException |
if a database access error occurs |
SQLFeatureNotSupportedException |
if the JDBC driver does not support this method |
Object getObject ()
检索此Ref
对象引用的SQL结构化类型实例。 如果连接的类型映射具有结构化类型的条目,则实例将自定义映射到类型映射中指示的Java类。 否则,结构化类型实例将映射到Struct
对象。
Returns | |
---|---|
Object |
a Java Object that is the mapping for the SQL structured type to which this Ref object refers |
Throws | |
---|---|
SQLException |
if a database access error occurs |
SQLFeatureNotSupportedException |
if the JDBC driver does not support this method |
也可以看看:
Object getObject (Map<String, Class<?>> map)
检索引用的对象并使用给定的类型映射将其映射到Java类型。
Parameters | |
---|---|
map |
Map : a java.util.Map object that contains the mapping to use (the fully-qualified name of the SQL structured type being referenced and the class object for SQLData implementation to which the SQL structured type will be mapped) |
Returns | |
---|---|
Object |
a Java Object that is the custom mapping for the SQL structured type to which this Ref object refers |
Throws | |
---|---|
SQLException |
if a database access error occurs |
SQLFeatureNotSupportedException |
if the JDBC driver does not support this method |
也可以看看:
void setObject (Object value)
设置此Ref
对象引用给定的实例Object
的结构化类型值。 驱动程序在将其发送到数据库时将其转换为SQL结构化类型。
Parameters | |
---|---|
value |
Object : an Object representing the SQL structured type instance that this Ref object will reference |
Throws | |
---|---|
SQLException |
if a database access error occurs |
SQLFeatureNotSupportedException |
if the JDBC driver does not support this method |