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.

Since:

1.5

See Also:

• Serialized Form

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	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 declared in class Object

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

Modifier and Type	Method	Description
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. Finalization is deprecated and subject to removal in a future release.
final Class<?>	getClass()	Returns the runtime class of this Object.
final void	notify()	Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll()	Wakes up all threads that are waiting on this object's monitor.
String	toString()	Returns a string representation of the object.
final void	wait()	Causes the current thread to wait until it is awakened, typically by being notified or interrupted.
final void	wait(long timeoutMillis)	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
final void	wait(long timeoutMillis, int nanos)	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

Constructor Details

SerialDatalink

public SerialDatalink(URL url)
               throws SerialException

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

Parameters:

url - the URL to create the SerialDataLink from

Throws:

SerialException - if url parameter is a null

Method Details

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(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