compact3

javax.sql.rowset.serial

Class SerialDatalink

java.lang.Object

javax.sql.rowset.serial.SerialDatalink

All Implemented Interfaces:

Serializable, Cloneable

public class SerialDatalink
extends Object
implements Serializable, Cloneable

A serialized mapping in the Java programming language of an SQL DATALINK value. A DATALINK value references a file outside of the underlying data source that the data source manages.

RowSet implementations can use the method RowSet.getURL to retrieve a java.net.URL object, which can be used to manipulate the external data.

      java.net.URL url = rowset.getURL(1);
 

Thread safety

A SerialDatalink is not safe for use by multiple concurrent threads. If a SerialDatalink is to be used by more than one thread then access to the SerialDatalink should be controlled by appropriate synchronization.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
SerialDatalink(URL url) Constructs a new SerialDatalink object from the given java.net.URL object.

Method Summary

Modifier and Type	Method and Description
Object	clone() Returns a clone of this SerialDatalink.
boolean	equals(Object obj) Compares this SerialDatalink to the specified object.
URL	getDatalink() Returns a new URL that is a copy of this SerialDatalink object.
int	hashCode() Returns a hash code for this SerialDatalink.

Methods inherited from class java.lang.Object

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

Constructor Detail

SerialDatalink

public SerialDatalink(URL url)
               throws SerialException

Constructs a new SerialDatalink object from the given java.net.URL object.

Throws:

SerialException - if url parameter is a null

Parameters:

url - the URL to create the SerialDataLink from

Method Detail

getDatalink

public URL getDatalink()
                throws SerialException

Returns a new URL that is a copy of this SerialDatalink object.

Throws:

SerialException - if the URL object cannot be de-serialized

Returns:

a copy of this SerialDatalink object as a URL object in the Java programming language.

equals

public boolean equals(Object obj)

Compares this SerialDatalink to the specified object. The result is true if and only if the argument is not null and is a SerialDatalink object whose URL is identical to this object's URL

Overrides:

equals in class Object

Parameters:

obj - The object to compare this SerialDatalink against

Returns:

true if the given object represents a SerialDatalink equivalent to this SerialDatalink, false otherwise

See Also:

Object.hashCode(), HashMap

hashCode

public int hashCode()

Returns a hash code for this SerialDatalink. The hash code for a SerialDatalink object is taken as the hash code of the URL it stores

Overrides:

hashCode in class Object

Returns:

a hash code value for this object.

See Also:

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

clone

public Object clone()

Returns a clone of this SerialDatalink.

Overrides:

clone in class Object

Returns:

a clone of this SerialDatalink

See Also:

Cloneable