Module jakarta.activation
Package jakarta.activation

Class URLDataSource

  • All Implemented Interfaces:
    DataSource
    public class URLDataSource
extends java.lang.Object
implements DataSource
    The URLDataSource class provides an object that wraps a URL object in a DataSource interface. URLDataSource simplifies the handling of data described by URLs within Jakarta Activation because this class can be used to create new DataHandlers. NOTE: The DataHandler object creates a URLDataSource internally, when it is constructed with a URL.
    See Also:
    DataSource, DataHandler

    • Constructor Summary

      Constructors 
      Constructor Description
      URLDataSource​(java.net.URL url)
      URLDataSource constructor.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.String getContentType()
      Returns the value of the URL content-type header field.
      java.io.InputStream getInputStream()
      The getInputStream method from the URL.
      java.lang.String getName()
      Calls the getFile method on the URL used to instantiate the object.
      java.io.OutputStream getOutputStream()
      The getOutputStream method from the URL.
      java.net.URL getURL()
      Return the URL used to create this DataSource.

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • URLDataSource

        public URLDataSource​(java.net.URL url)
        URLDataSource constructor. The URLDataSource class will not open a connection to the URL until a method requiring it to do so is called.
        Parameters:
        url - The URL to be encapsulated in this object.

    • Method Detail

      • getContentType

        public java.lang.String getContentType()
        Returns the value of the URL content-type header field. It calls the URL's URLConnection.getContentType method after retrieving a URLConnection object. Note: this method attempts to call the openConnection method on the URL. If this method fails, or if a content type is not returned from the URLConnection, getContentType returns "application/octet-stream" as the content type.
        Specified by:
        getContentType in interface DataSource
        Returns:
        the content type.

      • getName

        public java.lang.String getName()
        Calls the getFile method on the URL used to instantiate the object.
        Specified by:
        getName in interface DataSource
        Returns:
        the result of calling the URL's getFile method.

      • getInputStream

        public java.io.InputStream getInputStream()
                                   throws java.io.IOException
        The getInputStream method from the URL. Calls the openStream method on the URL.
        Specified by:
        getInputStream in interface DataSource
        Returns:
        the InputStream.
        Throws:
        java.io.IOException - for failures creating the InputStream

      • getOutputStream

        public java.io.OutputStream getOutputStream()
                                     throws java.io.IOException
        The getOutputStream method from the URL. First an attempt is made to get the URLConnection object for the URL. If that succeeds, the getOutputStream method on the URLConnection is returned.
        Specified by:
        getOutputStream in interface DataSource
        Returns:
        the OutputStream.
        Throws:
        java.io.IOException - for failures creating the OutputStream

      • getURL

        public java.net.URL getURL()
        Return the URL used to create this DataSource.
        Returns:
        The URL.