javax.activation

インタフェースDataContentHandler

public interface DataContentHandler

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

アプリケーションでは通常、DataContentHandlerのメソッドを直接呼び出すことはありません。かわりに、アプリケーションはDataHandler内にある同等のメソッドを呼び出します。DataHandlerは、現在のDataContentHandlerFactoryを使ってそのMIMEタイプに対応する適切なDataContentHandlerを捜し出そうとします。そして、DataHandlerは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 - ストリームへの書込み時に発生したエラー