モジュール java.activation
パッケージ javax.activation

インタフェースDataContentHandler



  • public interface DataContentHandler

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

    DataContentHandlerの実装は、引数なしのpublicコンストラクタを持つパブリック・クラスである必要があります。 実装クラスが名前付きモジュールにある場合は、モジュールjava.activationにエクスポートされるAPIパッケージに含まれている必要があります。

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

    導入されたバージョン:
    1.6
    • メソッドの詳細

      • 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 - ストリームへの書込み時に発生したエラー