Module java.sql.rowset

软件包 javax.sql.rowset.serial

Class SerialRef

java.lang.Object

javax.sql.rowset.serial.SerialRef

All Implemented Interfaces:

Serializable ， Cloneable ， Ref

public class SerialRef
extends Object
implements Ref, Serializable, Cloneable

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

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

线程安全

SerialRef对于多个并发线程使用是不安全的。 如果SerialRef由多个线程使用，则应通过适当的同步来控制对SerialRef的访问。

从以下版本开始：

1.5

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor	描述
SerialRef(Ref ref)	构造一个 SerialRef从给定对象 Ref对象。

方法摘要

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

Methods inherited from class java.lang.Object

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

构造方法详细信息

SerialRef

public SerialRef(Ref ref)
          throws SerialException,
                 SQLException

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

参数

ref - 一个Ref对象; 不能是null

异常

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

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

方法详细信息

getBaseTypeName

public String getBaseTypeName()
                       throws SerialException

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

Specified by:

getBaseTypeName在接口 Ref

结果

一个字符串的基类型名称的Ref

异常

SerialException - 没有设置Ref对象

getObject

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

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

Specified by:

getObject在接口 Ref

参数

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

结果

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

异常

SerialException - 如果在参考分辨率中遇到错误

另请参见：

Ref.setObject(java.lang.Object)

getObject

public Object getObject()
                 throws SerialException

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

Specified by:

getObject在接口 Ref

结果

从Ref引用解析的对象实例

异常

SerialException - 如果在参考分辨率中遇到错误

另请参见：

Ref.setObject(java.lang.Object)

setObject

public void setObject(Object obj)
               throws SerialException

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

Specified by:

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的对象

结果

true如果给定的对象表示一个 SerialRef等效于此SerialRef， 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