Package jakarta.activation
Class URLDataSource
- java.lang.Object
-
- jakarta.activation.URLDataSource
-
- All Implemented Interfaces:
DataSource
public class URLDataSource extends Object implements DataSource
The URLDataSource class provides an object that wraps aURL
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(URL url)
URLDataSource constructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description String
getContentType()
Returns the value of the URL content-type header field.InputStream
getInputStream()
The getInputStream method from the URL.String
getName()
Calls thegetFile
method on the URL used to instantiate the object.OutputStream
getOutputStream()
The getOutputStream method from the URL.URL
getURL()
Return the URL used to create this DataSource.
-
-
-
Constructor Detail
-
URLDataSource
public URLDataSource(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 String getContentType()
Returns the value of the URL content-type header field. It calls the URL'sURLConnection.getContentType
method after retrieving a URLConnection object. Note: this method attempts to call theopenConnection
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 interfaceDataSource
- Returns:
- the content type.
-
getName
public String getName()
Calls thegetFile
method on the URL used to instantiate the object.- Specified by:
getName
in interfaceDataSource
- Returns:
- the result of calling the URL's getFile method.
-
getInputStream
public InputStream getInputStream() throws IOException
The getInputStream method from the URL. Calls theopenStream
method on the URL.- Specified by:
getInputStream
in interfaceDataSource
- Returns:
- the InputStream.
- Throws:
IOException
- for failures creating the InputStream
-
getOutputStream
public OutputStream getOutputStream() throws 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 interfaceDataSource
- Returns:
- the OutputStream.
- Throws:
IOException
- for failures creating the OutputStream
-
getURL
public URL getURL()
Return the URL used to create this DataSource.- Returns:
- The URL.
-
-