JavaTM 2 Platform
Standard Ed. 5.0

javax.imageio.stream
クラス FileCacheImageInputStream

java.lang.Object
  上位を拡張 javax.imageio.stream.ImageInputStreamImpl
      上位を拡張 javax.imageio.stream.FileCacheImageInputStream
すべての実装されたインタフェース:
DataInput, ImageInputStream

public class FileCacheImageInputStream
extends ImageInputStreamImpl

通常の InputStream から入力を取得する ImageInputStream の実装です。ファイルは、以前に読み込んだデータのキャシュとして使用されます。


フィールドの概要
 
クラス javax.imageio.stream.ImageInputStreamImpl から継承されたフィールド
bitOffset, byteOrder, flushedPos, streamPos
 
コンストラクタの概要
FileCacheImageInputStream(InputStream stream, File cacheDir)
          指定された InputStream から読み込む FileCacheImageInputStream を構築します。
 
メソッドの概要
 void close()
          この FileCacheImageInputStream を閉じます。
 boolean isCached()
          後方へのシークを可能にするために、この ImageInputStream がデータをキャッシュするため、true が返されます。
 boolean isCachedFile()
          この ImageInputStream はファイルキャッシュを維持するため、true が返されます。
 boolean isCachedMemory()
          この ImageInputStream はメインメモリキャッシュを維持しないため、false が返されます。
 int read()
          ストリームから 1 バイトを読み込み、それを 0 から 255 までの整数として返します。
 int read(byte[] b, int off, int len)
          ストリームから len バイトまで読み込み、b にインデックス off から格納します。
 
クラス javax.imageio.stream.ImageInputStreamImpl から継承されたメソッド
checkClosed, finalize, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, length, mark, read, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedShort, readUTF, reset, seek, setBitOffset, setByteOrder, skipBytes, skipBytes
 
クラス java.lang.Object から継承されたメソッド
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

FileCacheImageInputStream

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

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

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

read

public int read()
         throws IOException
インタフェース ImageInputStream の記述:
ストリームから 1 バイトを読み込み、それを 0 から 255 までの整数として返します。ストリームの終わりに達すると -1 を返します。

ストリーム内のビットオフセットは、読み込みを行う前に 0 にリセットされます。

定義:
インタフェース ImageInputStream 内の read
定義:
クラス ImageInputStreamImpl 内の read
戻り値:
ストリームからのバイト値 (int)、または -1 (EOF を示す)
例外:
IOException - 入出力エラーが発生した場合

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException
クラス ImageInputStreamImpl の記述:
ストリームから len バイトまで読み込み、b にインデックス off から格納します。読み込んだバイト数を返します。ストリームの終りに達したためにバイトを読み込めない場合は、-1 を返します。

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

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

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

isCached

public boolean isCached()
後方へのシークを可能にするために、この ImageInputStream がデータをキャッシュするため、true が返されます。

定義:
インタフェース ImageInputStream 内の isCached
オーバーライド:
クラス ImageInputStreamImpl 内の isCached
戻り値:
true
関連項目:
isCachedMemory(), isCachedFile()

isCachedFile

public boolean isCachedFile()
この ImageInputStream はファイルキャッシュを維持するため、true が返されます。

定義:
インタフェース ImageInputStream 内の isCachedFile
オーバーライド:
クラス ImageInputStreamImpl 内の isCachedFile
戻り値:
true
関連項目:
isCached(), isCachedMemory()

isCachedMemory

public boolean isCachedMemory()
この ImageInputStream はメインメモリキャッシュを維持しないため、false が返されます。

定義:
インタフェース ImageInputStream 内の isCachedMemory
オーバーライド:
クラス ImageInputStreamImpl 内の isCachedMemory
戻り値:
false
関連項目:
isCached(), isCachedFile()

close

public void close()
           throws IOException
この FileCacheImageInputStream を閉じます。キャッシュファイルは閉じられ、削除されます。ソース InputStream は閉じられません。

定義:
インタフェース ImageInputStream 内の close
オーバーライド:
クラス ImageInputStreamImpl 内の close
例外:
IOException - エラーが発生する場合

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。