| |
|
| javax.activation.DataContentHandler
DataContentHandler | public interface DataContentHandler (Code) | | The DataContentHandler interface is implemented by objects that can
be used to extend the capabilities of the DataHandler's implementation
of the Transferable interface. Through DataContentHandlers
the framework can be extended to convert streams in to objects, and
to write objects to streams.
Applications don't generally call the methods in DataContentHandlers
directly. Instead, an application calls the equivalent methods in
DataHandler. The DataHandler will attempt to find an appropriate
DataContentHandler that corresponds to its MIME type using the
current DataContentHandlerFactory. The DataHandler then calls
through to the methods in the DataContentHandler.
since: 1.6 |
Method Summary | |
public Object | getContent(DataSource ds) Return an object representing the data in its most preferred form.
Generally this will be the form described by the first DataFlavor
returned by the getTransferDataFlavors method.
Parameters: ds - The DataSource representing the data to be converted. | public Object | getTransferData(DataFlavor df, DataSource ds) Returns an object which represents the data to be transferred.
The class of the object returned is defined by the representation class
of the flavor.
Parameters: df - The DataFlavor representing the requested type. Parameters: ds - The DataSource representing the data to be converted. | public DataFlavor[] | getTransferDataFlavors() Returns an array of DataFlavor objects indicating the flavors the
data can be provided in. | public void | writeTo(Object obj, String mimeType, OutputStream os) Convert the object to a byte stream of the specified MIME type
and write it to the output stream. |
getContent | public Object getContent(DataSource ds) throws IOException(Code) | | Return an object representing the data in its most preferred form.
Generally this will be the form described by the first DataFlavor
returned by the getTransferDataFlavors method.
Parameters: ds - The DataSource representing the data to be converted. The constructed Object. exception: IOException - if the data can't be accessed |
getTransferData | public Object getTransferData(DataFlavor df, DataSource ds) throws UnsupportedFlavorException, IOException(Code) | | Returns an object which represents the data to be transferred.
The class of the object returned is defined by the representation class
of the flavor.
Parameters: df - The DataFlavor representing the requested type. Parameters: ds - The DataSource representing the data to be converted. The constructed Object. exception: UnsupportedFlavorException - if the handler doesn'tsupport the requested flavor exception: IOException - if the data can't be accessed |
getTransferDataFlavors | public DataFlavor[] getTransferDataFlavors()(Code) | | Returns an array of DataFlavor objects indicating the flavors the
data can be provided in. The array should be ordered according to
preference for providing the data (from most richly descriptive to
least descriptive).
The DataFlavors. |
writeTo | public void writeTo(Object obj, String mimeType, OutputStream os) throws IOException(Code) | | Convert the object to a byte stream of the specified MIME type
and write it to the output stream.
Parameters: obj - The object to be converted. Parameters: mimeType - The requested MIME type of the resulting byte stream. Parameters: os - The output stream into which to write the convertedbyte stream. exception: IOException - errors writing to the stream |
|
|
|