javax.sql.rowset.serial

Class 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.
    See Also:
    Serialized Form

    • Constructor Summary

      Constructors

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

    • Method Summary

      Modifier and Type Method and 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.

    • 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

      • clone

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