パッケージ jakarta.activation

インターフェース DataContentHandler

  • public interface DataContentHandler
    DataContentHandler インターフェースは、DataHandler の Transferable インターフェースの実装の機能を継承するために使用できるオブジェクトによって実装されます。DataContentHandlers を介して、フレームワークを継承して、ストリームをオブジェクトに変換したり、オブジェクトをストリームに書き込んだりすることができます。

    アプリケーションは通常、DataContentHandlers のメソッドを直接呼び出すことはありません。代わりに、アプリケーションは DataHandler の同等のメソッドを呼び出します。DataHandler は、現在の DataContentHandlerFactory を使用して、その MIME 型に対応する適切な DataContentHandler を見つけようとします。次に、DataHandler は DataContentHandler のメソッドを呼び出します。

    • メソッドの詳細

      • getTransferDataFlavors

        ActivationDataFlavor[] getTransferDataFlavors()
        データを提供できるフレーバーを示す ActivationDataFlavor オブジェクトの配列を返します。配列は、データを提供するための設定に従って（最も説明の豊富なものから最も説明の少ないものへ）順序付けする必要があります。
        戻り値:
        ActivationDataFlavors。

      • getTransferData

        ObjectSE getTransferData​(ActivationDataFlavor df,
                       DataSource ds)
                throws IOExceptionSE
        転送されるデータを表すオブジェクトを返します。返されるオブジェクトのクラスは、フレーバーの表現クラスによって定義されます。
        パラメーター:
        df - リクエストされた型を表す ActivationDataFlavor。
        ds - 変換するデータを表す DataSource。
        戻り値:
        構築されたオブジェクト。
        例外:
        IOExceptionSE - ハンドラーがリクエストされたフレーバーをサポートしていない場合
        IOExceptionSE - データにアクセスできない場合

      • getContent

        ObjectSE getContent​(DataSource ds)
           throws IOExceptionSE
        最も推奨する形式でデータを表すオブジェクトを返します。通常、これは getTransferDataFlavors メソッドによって返される最初の ActivationDataFlavor によって記述される形式になります。
        パラメーター:
        ds - 変換するデータを表す DataSource。
        戻り値:
        構築されたオブジェクト。
        例外:
        IOExceptionSE - データにアクセスできない場合

      • writeTo

        void writeTo​(ObjectSE obj,
             StringSE mimeType,
             OutputStreamSE os)
      throws IOExceptionSE
        オブジェクトを指定された MIME 型のバイトストリームに変換し、出力ストリームに書き込みます。
        パラメーター:
        obj - 変換するオブジェクト。
        mimeType - 結果のバイトストリームのリクエストされた MIME 型。
        os - 変換されたバイトストリームを書き込む出力ストリーム。
        例外:
        IOExceptionSE - ストリームへの書き込みエラー