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:

  • 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.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    getClass()
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    final void
    notify()
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    notifyAll()
    Causes all threads which are waiting on the receiver to be made ready to run.
    String
    toString()
    Answers a string containing a concise, human-readable description of the receiver.
    final void
    wait()
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

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

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

    • clone

      public Object clone()
      Returns a clone of this SerialDatalink.
      Overrides:
      clone in class Object
      Returns:
      a clone of this SerialDatalink