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.
    Since:
    1.5
    See Also:
    Serialized Form
    • 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