
Contents \| Package \| Class \| Tree \| Deprecated \| Index \| Help
PREV \| NEXT	SHOW LISTS \| HIDE LISTS

Interface javax.activation.DataContentHandler

public interface DataContentHandler

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 data to objects. (see below)

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 it's MIME type in it's current DataContentHandlerFactory. The DataHandler then calls through to the methods in DataContentHandler.

Method Summary

java.lang.Object getContent(DataSource ds)

Return an object representing the data in its most preferred form.

java.lang.Object getTransferData(java.awt.datatransfer.DataFlavor df, DataSource ds)

Returns an object which represents the data to be transferred.

java.awt.datatransfer.DataFlavor[] getTransferDataFlavors()

Returns an array of DataFlavor objects indicating the flavors the data can be provided in.

void writeTo(java.lang.Object obj, java.lang.String mimeType, java.io.OutputStream os)

Convert the object to a byte stream of the specified MIME type and write it to the output stream.

Method Detail

getTransferDataFlavors

public java.awt.datatransfer.DataFlavor[] getTransferDataFlavors()

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).

Returns:: The DataFlavors.

getTransferData

public java.lang.Object getTransferData(java.awt.datatransfer.DataFlavor df,
                              DataSource ds) throws java.awt.datatransfer.UnsupportedFlavorException, java.io.IOException

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..; ds - The DataSource representing the data to be converted.
Returns:: The constructed Object.

getContent

public java.lang.Object getContent(DataSource ds) throws java.io.IOException

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.

writeTo

public void writeTo(java.lang.Object obj,
                    java.lang.String mimeType,
                    java.io.OutputStream os) throws java.io.IOException

Convert the object to a byte stream of the specified MIME type and write it to the output stream.


Contents \| Package \| Class \| Tree \| Deprecated \| Index \| Help
PREV \| NEXT	SHOW LISTS \| HIDE LISTS

Method Summary
java.lang.Object	getContent(DataSource ds) Return an object representing the data in its most preferred form.
java.lang.Object	getTransferData(java.awt.datatransfer.DataFlavor df, DataSource ds) Returns an object which represents the data to be transferred.
java.awt.datatransfer.DataFlavor[]	getTransferDataFlavors() Returns an array of DataFlavor objects indicating the flavors the data can be provided in.
void	writeTo(java.lang.Object obj, java.lang.String mimeType, java.io.OutputStream os) Convert the object to a byte stream of the specified MIME type and write it to the output stream.