モジュール java.desktop
パッケージ 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 - fnullの場合。
        SecurityException - セキュリティ・マネージャが存在し、ファイルへの読込みアクセスが許可されない場合。
        FileNotFoundException - fがディレクトリであるか、ほかの何らかの理由で読込み用に開くことができない場合。
        IOException - 入出力エラーが発生した場合。
      • FileImageInputStream

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

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

        パラメータ:
        raf - 読込み元のRandomAccessFile
        例外:
        IllegalArgumentException - rafnullの場合。
    • メソッドの詳細

      • 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
      • seek

        public void seek​(long pos)
                  throws IOException
        インタフェースからコピーされた説明: ImageInputStream
        現在のストリーム位置を目的の位置に設定します。 次回の読込みはこの位置で行われます。 ビット・オフセットは0に設定されます。

        posgetflushedPositionから返されるフラッシュ位置よりも小さい場合は、IndexOutOfBoundsExceptionがスローされます。

        ファイルの最後を追い抜くことは合法です。java.io.EOFExceptionは、読み取りが実行された場合にのみスローされます。

        定義:
        seek、インタフェース: ImageInputStream
        オーバーライド:
        seek、クラス: ImageInputStreamImpl
        パラメータ:
        pos - 目的のファイル・ポインタ位置を示すlong
        例外:
        IOException - その他の入出力エラーが発生した場合。
      • close

        public void close​()
                   throws IOException
        インタフェースからコピーされた説明: ImageInputStream
        ストリームを閉じます。 閉じたストリームにアクセスしようとすると、IOExceptionがスローされるか不正な動作が実行される場合があります。 このメソッドを呼び出すと、このインタフェースを実装するクラスが、メモリー、ディスク・スペース、またはファイル記述子などのストリームに関連するリソースを解放できます。
        定義:
        close、インタフェース: AutoCloseable
        定義:
        close、インタフェース: Closeable
        定義:
        close、インタフェース: ImageInputStream
        オーバーライド:
        close、クラス: ImageInputStreamImpl
        例外:
        IOException - 入出力エラーが発生した場合。
      • 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