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 Detail

    - #### 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 Detail

    - #### 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`