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

クラスFileCacheImageInputStream

java.lang.Object
javax.imageio.stream.ImageInputStreamImpl
javax.imageio.stream.FileCacheImageInputStream
すべての実装されたインタフェース:
Closeable, DataInput, AutoCloseable, ImageInputStream
public class FileCacheImageInputStream extends ImageInputStreamImpl
通常のInputStreamから入力を取得するImageInputStreamの実装です。 ファイルは、以前に読み込んだデータのキャッシュとして使用されます。

  • コンストラクタの詳細

    • FileCacheImageInputStream

      public FileCacheImageInputStream(InputStream stream, File cacheDir) throws IOException
      指定されたInputStreamから読み込むFileCacheImageInputStreamを構築します。

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

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

  • メソッドの詳細

    • read

      public int read() throws IOException
      クラスからコピーされた説明: ImageInputStreamImpl
      ストリームから1バイトを読み込み、それを0から255までのintとして返します。 EOFに達すると-1を返します。

      サブクラスでこのメソッドを実装する必要があります。 サブクラス実装で終了する前にストリーム位置を更新します。

      ストリーム内のビット・オフセットは、読込みを行う前に0にリセットする必要があります。

      定義:
      read、インタフェースImageInputStream
      定義:
      read、クラスImageInputStreamImpl
      戻り値:
      ストリーム内の次のバイトの値。または、EOFに達した場合は-1。
      スロー:
      IOException - ストリームが閉じられている場合。

    • read

      public int read(byte[] b, int off, int len) throws IOException
      クラスからコピーされた説明: ImageInputStreamImpl
      ストリームから最大lenバイトを読み込み、bにインデックスoffから格納します。 ストリームの終わりに達したためにバイトを読み込めない場合は、-1を返します。

      ストリーム内のビット・オフセットは、読込みを行う前に0にリセットする必要があります。

      サブクラスでこのメソッドを実装する必要があります。 サブクラス実装で終了する前にストリーム位置を更新します。

      定義:
      read、インタフェースImageInputStream
      定義:
      read、クラスImageInputStreamImpl
      パラメータ:
      b - 書き込まれるバイト配列。
      off - 書込み先のb内の開始位置。
      len - 読み込む最大バイト数。
      戻り値:
      実際に読み込まれたバイト数、またはEOFを示す-1。
      スロー:
      IOException - 入出力エラーが発生した場合。

    • isCached

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

    • isCachedFile

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

    • isCachedMemory

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

    • close

      public void close() throws IOException
      このFileCacheImageInputStreamを閉じます。キャッシュ・ファイルは閉じられ、削除されます。 ソースInputStreamは閉じられません。
      スロー:
      IOException - エラーが発生した場合

    • finalize

      @Deprecated(since="9", forRemoval=true) protected void finalize() throws Throwable
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      最終決定は削除のために非推奨になりました。 移行オプションについてのバックグラウンド情報および詳細は、Object.finalize()を参照してください。
      ガベージ・コレクションの前にこのオブジェクトをファイナライズします。 closeメソッドを呼び出して、開いている入力ソースをすべて閉じます。 このメソッドを、アプリケーション・コードから呼び出してはいけません。
      オーバーライド:
      finalize、クラスImageInputStreamImpl
      スロー:
      Throwable - スーパー・クラスのファイナライズ時にエラーが発生した場合。
      関連項目: