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

クラスFileImageInputStream

java.lang.Object
javax.imageio.stream.ImageInputStreamImpl
javax.imageio.stream.FileImageInputStream
すべての実装されたインタフェース:
Closeable, DataInput, AutoCloseable, ImageInputStream
public class FileImageInputStream extends ImageInputStreamImpl
FileまたはRandomAccessFileから入力を取得するImageInputStreamの実装です。 ファイルの内容は、オブジェクトの有効期間中は安定していると見なされます。

  • コンストラクタの詳細

    • FileImageInputStream

      public FileImageInputStream​(File f) throws FileNotFoundException, IOException
      指定されたFileから読み込むFileImageInputStreamを構築します。

      このオブジェクトの構築時から読込みメソッドを最後に呼び出すまでの間、ファイルの内容を変更してはいけません。

      パラメータ:
      f - 読込み元のFile。
      例外:
      IllegalArgumentException - fがnullの場合。
      SecurityException - セキュリティ・マネージャが存在し、ファイルへの読込みアクセスが許可されない場合。
      FileNotFoundException - fがディレクトリであるか、ほかの何らかの理由で読込み用に開くことができない場合。
      IOException - 入出力エラーが発生した場合。

    • FileImageInputStream

      public FileImageInputStream​(RandomAccessFile raf)
      指定されたRandomAccessFileから読み込むFileImageInputStreamを構築します。

      このオブジェクトの構築時から読込みメソッドを最後に呼び出すまでの間、ファイルの内容を変更してはいけません。

      パラメータ:
      raf - 読込み元のRandomAccessFile。
      例外:
      IllegalArgumentException - rafがnullの場合。

  • メソッドの詳細

    • 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 - 入出力エラーが発生した場合。

    • length

      public long length()
      基本となるファイルの長さ、またはそれが不明な場合は-1を返します。
      定義:
      length、インタフェース: ImageInputStream
      オーバーライド:
      length、クラス: ImageInputStreamImpl
      戻り値:
      ファイルの長さ(long)、または-1。

    • finalize

      @Deprecated(since="9") protected void finalize() throws Throwable
      非推奨。
      finalizeメソッドは推奨されていません。 クリーンアップを実行するためにfinalizeをオーバーライドするサブクラスは、代替クリーンアップ・メカニズムを使用し、オーバーライドするfinalizeメソッドを削除するように変更する必要があります。 finalizeメソッドをオーバーライドする場合、実装では、super.finalize()がObject.finalize()の説明に従って呼び出されることを明示的に確認する必要があります。 移行オプションの詳細については、Object.finalize()の仕様を参照してください。
      ガベージ・コレクションの前にこのオブジェクトをファイナライズします。 closeメソッドを呼び出して、開いている入力ソースをすべて閉じます。 このメソッドを、アプリケーション・コードから呼び出してはいけません。
      オーバーライド:
      finalize、クラス: ImageInputStreamImpl
      例外:
      Throwable - スーパー・クラスのファイナライズ時にエラーが発生した場合。
      関連項目:
      WeakReference, PhantomReference