Class SerialDatalink

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.

Constructors

SerialDatalink

public SerialDatalink(URL url)
               throws SerialException

Parameters:

url - the URL to create the SerialDataLink from

Throws:

SerialException - if url parameter is a null

Methods

getDatalink

public URL getDatalink()
                throws SerialException

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

Returns:

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

Throws:

SerialException - if the URL object cannot be de-serialized

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