モジュール java.desktop
パッケージ javax.imageio.stream

クラスFileCacheImageOutputStream

java.lang.Object
javax.imageio.stream.ImageInputStreamImpl
javax.imageio.stream.ImageOutputStreamImpl
javax.imageio.stream.FileCacheImageOutputStream
すべての実装されたインタフェース:
Closeable, DataInput, DataOutput, AutoCloseable, ImageInputStream, ImageOutputStream
public class FileCacheImageOutputStream
extends ImageOutputStreamImpl
出力を通常のOutputStreamに書き込むImageOutputStreamの実装です。 ファイルは、データを出力ストリームにフラッシュするまでキャッシュとして使用されます。

  • コンストラクタの詳細

    • FileCacheImageOutputStream

      public FileCacheImageOutputStream​(OutputStream stream, File cacheDir) throws IOException
      指定されたoutputStreamに書き込むFileCacheImageOutputStreamを構築します。

      一時ファイルがキャッシュとして使用されます。 cacheDir がnullではなく、ディレクトリである場合、ファイルがそこに作成されます。 nullの場合、システム固有のデフォルト一時ファイル・ディレクトリが使用されます。詳細はFile.createTempFileのドキュメントを参照してください。

      パラメータ:
      stream - 書込み先のOutputStream。
      cacheDir - キャッシュ・ファイルが作成される場所を示すFile。システム・ディレクトリを使用する場合はnull。
      例外:
      IllegalArgumentException - streamがnullの場合。
      IllegalArgumentException - cacheDirがnull以外であるが、ディレクトリではない場合。
      IOException - キャッシュ・ファイルを作成できない場合。

  • メソッドの詳細

    • seek

      public void seek​(long pos) throws IOException
      現在のストリーム位置を設定してビット・オフセットを0にリセットします。 シークでファイルの終わりを通過することは正常であり、EOFExceptionは読込みの場合のみスローされます。 書込みが実行されるまで、ファイル長は増加しません。
      パラメータ:
      pos - 目的のファイル・ポインタ位置を示すlong。
      例外:
      IndexOutOfBoundsException - posがフラッシュ位置よりも小さい場合。
      IOException - その他の入出力エラーが発生した場合。

    • isCached

      public boolean isCached()
      後方へのシークを可能にするために、このImageOutputStreamがデータをキャッシュするため、trueが返されます。
      定義:
      isCached、インタフェース: ImageInputStream
      オーバーライド:
      isCached、クラス: ImageInputStreamImpl
      戻り値:
      true
      関連項目:
      isCachedMemory(), isCachedFile()

    • isCachedFile

      public boolean isCachedFile()
      このImageOutputStreamはファイル・キャッシュを維持するため、trueが返されます。
      定義:
      isCachedFile、インタフェース: ImageInputStream
      オーバーライド:
      isCachedFile、クラス: ImageInputStreamImpl
      戻り値:
      true
      関連項目:
      isCached(), isCachedMemory()

    • isCachedMemory

      public boolean isCachedMemory()
      このImageOutputStreamはメイン・メモリー・キャッシュを維持しないため、falseが返されます。
      定義:
      isCachedMemory、インタフェース: ImageInputStream
      オーバーライド:
      isCachedMemory、クラス: ImageInputStreamImpl
      戻り値:
      false
      関連項目:
      isCached(), isCachedFile()

    • close

      public void close() throws IOException
      このFileCacheImageOutputStreamを閉じます。 保留中のデータはすべて出力にフラッシュされ、キャッシュ・ファイルは閉じられて削除されます。 出力先OutputStreamは閉じられません。
      例外:
      IOException - エラーが発生した場合