Module java.sql.rowset
Package 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.
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 java.lang.Object

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

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