-
public interface DataContentHandler
DataContentHandlerインタフェースは、TransferableインタフェースのDataHandlerの実装の機能を拡張するためのオブジェクトによって実装されます。
DataContentHandlers
を介して、ストリームがオブジェクトに変換されたり、オブジェクトがストリームに書き込まれたりするように、フレームワークを拡張できます。DataContentHandlerの実装は、引数なしのpublicコンストラクタを持つパブリック・クラスである必要があります。 実装クラスが名前付きモジュールにある場合は、モジュール
java.activation
にエクスポートされるAPIパッケージに含まれている必要があります。アプリケーションでは通常、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
- ストリームへの書込み時に発生したエラー
-
-