Module java.sql.rowset

Package javax.sql.rowset.serial

Class SerialRef

java.lang.Object

javax.sql.rowset.serial.SerialRef

所有已实现的接口:

Serializable, Cloneable, Ref

       public class SerialRef extends Object implements Ref, Serializable, Cloneable
      

一个Ref对象的序列化映射，这是Java编程语言中SQL REF值的映射。

SerialRef类提供了一个从Ref对象创建SerialRef实例的构造函数，并提供了用于获取和设置Ref对象的方法。

线程安全性

SerialRef不适合多个并发线程使用。如果一个SerialRef将被多个线程使用，则对SerialRef的访问应该受到适当的同步控制。

自版本:

1.5

参见:

• 序列化形式

Constructor Summary

Constructors

Constructor	Description
SerialRef(Ref ref)	构造一个SerialRef对象，从给定的Ref对象。

Method Summary

Modifier and Type	Method	Description
Object	clone()	返回此SerialRef的克隆。
boolean	equals(Object obj)	将此SerialRef与指定对象进行比较。
String	getBaseTypeName()	返回描述Ref的基本类型名称的字符串。
Object	getObject()	返回表示此SerialRef对象引用的SQL结构化类型的Object。
Object	getObject(Map<String,Class<?>> map)	返回表示此SerialRef对象引用的SQL结构化类型的Object。
int	hashCode()	返回此SerialRef的哈希码。
void	setObject(Object obj)	将此SerialRef对象引用的SQL结构化类型设置为给定的Object对象。

Methods declared in class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

SerialRef

             public SerialRef(Ref ref) throws SerialException, SQLException
            

构造一个SerialRef对象，从给定的Ref对象。

参数:

ref - 一个Ref对象；不能为null

抛出:

SQLException - 如果发生数据库访问；如果ref为null；或者如果Ref对象返回一个null值基本类型名称。

SerialException - 如果在序列化Ref对象时发生错误

Method Details

getBaseTypeName

             public String getBaseTypeName() throws SerialException
            

返回描述Ref的基本类型名称的字符串。

指定者:

getBaseTypeName 在接口 Ref

返回:

Ref的基本类型名称的字符串

抛出:

SerialException - 如果没有设置Ref对象

getObject

             public Object getObject(Map<String,Class<?>> map) throws SerialException
            

返回表示此SerialRef对象引用的SQL结构化类型的Object。根据给定的类型映射，将结构化类型的属性进行映射。

指定者:

getObject 在接口 Ref

参数:

map - 一个java.util.Map对象，包含零个或多个条目，每个条目由1)给出UDT的完全限定名称的String和2)定义如何映射UDT的SQLData实现的Class对象组成

返回:

从Ref引用解析并根据提供的类型映射进行映射的对象实例

抛出:

SerialException - 如果在引用解析中遇到错误

参见:

• Ref.setObject(java.lang.Object)

getObject

             public Object getObject() throws SerialException
            

返回表示此SerialRef对象引用的SQL结构化类型的Object。

指定者:

getObject 在接口 Ref

返回:

从Ref引用解析的对象实例

抛出:

SerialException - 如果在引用解析中遇到错误

参见:

• Ref.setObject(java.lang.Object)

setObject

             public void setObject(Object obj) throws SerialException
            

将此SerialRef对象引用的SQL结构化类型设置为给定的Object对象。

指定者:

setObject 在接口 Ref

参数:

obj - 表示要引用的SQL结构化类型的Object

抛出:

SerialException - 如果在生成此SerialRef对象引用的结构化类型时遇到错误

参见:

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

equals

             public boolean equals(Object obj)
            

将此SerialRef与指定对象进行比较。如果参数不为null且是代表与此对象相同对象的SerialRef对象，则结果为true。

覆盖:

equals 在类 Object

参数:

obj - 要将此SerialRef与之比较的对象

返回:

如果给定对象表示与此SerialRef等效的SerialRef，则为true，否则为false

参见:

• Object.hashCode()
• HashMap

hashCode

             public int hashCode()
            

返回此SerialRef的哈希码。

覆盖:

hashCode 在类 Object

返回:

此对象的哈希码值。

参见:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)

clone

             public Object clone()
            

返回此SerialRef的克隆。底层的Ref对象将被设置为null。

覆盖:

clone 在类 Object

返回:

此SerialRef的克隆

参见:

• Cloneable