javax.activation
インタフェース DataContentHandler

public interface DataContentHandler

DataContentHandler インタフェースは、Transferable インタフェースの DataHandler の実装の機能を拡張するためのオブジェクトによって実装されます。DataContentHandlers を介して、ストリームがオブジェクトに変換されたり、オブジェクトがストリームに書き込まれたりするように、フレームワークを拡張できます。

アプリケーションでは通常、DataContentHandler のメソッドを直接呼び出すのではなく、DataHandler 内にある同等のメソッドを呼び出します。 DataHandler は、現在の DataContentHandlerFactory を使ってその MIME タイプに対応する適切な DataContentHandler を捜し出そうとします。そして、DataContentHandler のメソッドを呼び出します。

導入されたバージョン:

1.6

メソッドの概要

Object	getContent(DataSource ds) もっとも適した形式のデータを表すオブジェクトを返します。
Object	getTransferData(DataFlavor df, DataSource ds) 転送されるデータを表すオブジェクトを返します。
DataFlavor[]	getTransferDataFlavors() データを提供することができるフレーバを示す DataFlavor オブジェクトの配列を返します。
void	writeTo(Object obj, String mimeType, OutputStream os) 指定された MIME タイプのバイトストリームにオブジェクトを変換し、出力ストリームに書き出します。

メソッドの詳細

getTransferDataFlavors

DataFlavor[] getTransferDataFlavors()

データを提供することができるフレーバを示す DataFlavor オブジェクトの配列を返します。 配列は、データ提供のための優先設定に従って (もっとも詳しく記述されているものから、そうでないものへ) 順序付けされなければなりません。

戻り値:

DataFlavor

getTransferData

Object getTransferData(DataFlavor df,
                       DataSource ds)
                       throws UnsupportedFlavorException,
                              IOException

転送されるデータを表すオブジェクトを返します。返されるオブジェクトのクラスは、フレーバの表現クラスで定義されます。

パラメータ:

df - 要求されたタイプを表す DataFlavor

ds - 変換されるデータを表す DataSource

戻り値:

構築された Object

例外:

UnsupportedFlavorException - 要求されたフレーバをハンドラがサポートしない場合

IOException - データにアクセスできない場合

getContent

Object getContent(DataSource ds)
                  throws IOException

もっとも適した形式のデータを表すオブジェクトを返します。 一般に、これは getTransferDataFlavors メソッドによって返された最初の DataFlavor で記述された形式となります。

パラメータ:

ds - 変換されるデータを表す DataSource

戻り値:

構築された Object

例外:

IOException - データにアクセスできない場合

writeTo

void writeTo(Object obj,
             String mimeType,
             OutputStream os)
             throws IOException

指定された MIME タイプのバイトストリームにオブジェクトを変換し、出力ストリームに書き出します。

パラメータ:

obj - 変換されるオブジェクト

mimeType - 生成されるバイトストリームの MIME タイプ

os - 変換されたバイトストリームを書き込む出力ストリーム

例外:

IOException - ストリームへの書き込み時に発生したエラー