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

クラスImageInputStreamImpl

    • フィールドの詳細

      • byteOrder

        protected ByteOrder byteOrder
        列挙クラスjava.nio.ByteOrderのインスタンスで表されるストリームのバイト順で、ByteOrder.BIG_ENDIANはネットワーク・バイト順、ByteOrder.LITTLE_ENDIANは逆順を示します。 デフォルト値はByteOrder.BIG_ENDIANです。

      • streamPos

        protected long streamPos
        ストリーム内の現在の読込み位置です。 サブクラスがオーバーライドする、読込み位置を変更するすべてのメソッドからこの値を保護し、現状のままに保つことは、サブクラスの責任です。

      • bitOffset

        protected int bitOffset
        ストリーム内の現在のビット・オフセットです。 サブクラスがオーバーライドする、ビット・オフセットを変更するすべてのメソッドからこの値を保護し、現状のままに保つことは、サブクラスの責任です。

      • flushedPos

        protected long flushedPos
        それより前のデータが破棄される位置です。 これより前の位置にシークすることはできません。flushedPosは常に0以上になります。

    • コンストラクタの詳細

      • ImageInputStreamImpl

        public ImageInputStreamImpl()
        ImageInputStreamImplを構築します。

    • メソッドの詳細

      • checkClosed

        protected final void checkClosed()
                          throws IOException
        ストリームが閉じられていた場合はIOExceptionをスローします。 サブクラスは、ストリームが開いていることが必要などのメソッドからも、このメソッドを呼び出すことができます。
        例外:
        IOException - ストリームが閉じられている場合。

      • read

        public abstract int read()
                  throws IOException
        ストリームから1バイトを読み込み、それを0から255までのintとして返します。 EOFに達すると-1を返します。

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

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

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

      • read

        public int read​(byte[] b)
         throws IOException
        read(b, 0, b.length)を呼び出す簡易メソッドです。

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

        定義:
        read、インタフェースImageInputStream
        パラメータ:
        b - 書き込まれるバイト配列。
        戻り値:
        実際に読み込まれたバイト数、またはEOFを示す-1。
        例外:
        NullPointerException - bがnullである場合。
        IOException - 入出力エラーが発生した場合。

      • read

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

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

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

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

      • length

        public long length()
        ストリームが未知の長さであることを示す-1Lを返します。 サブクラスでこのメソッドをオーバーライドして、実際の長さの情報を指定する必要があります。
        定義:
        length、インタフェースImageInputStream
        戻り値:
        未知の長さを示す -1L

      • skipBytes

        public int skipBytes​(int n)
              throws IOException
        seek(getStreamPosition()+n)を呼び出して、現在のストリーム位置を前進させます。

        ビット・オフセットは0にリセットされます。

        定義:
        skipBytes、インタフェースDataInput
        定義:
        skipBytes、インタフェースImageInputStream
        パラメータ:
        n - 前方にシークするバイト数。
        戻り値:
        スキップされたバイト数を示すint。
        例外:
        IOException - 開始または終了位置を計算する際にgetStreamPositionがIOExceptionをスローする場合。

      • skipBytes

        public long skipBytes​(long n)
               throws IOException
        seek(getStreamPosition()+n)を呼び出して、現在のストリーム位置を前進させます。

        ビット・オフセットは0にリセットされます。

        定義:
        skipBytes、インタフェースImageInputStream
        パラメータ:
        n - 前方にシークするバイト数。
        戻り値:
        スキップされたバイト数を示すlong。
        例外:
        IOException - 開始または終了位置を計算する際にgetStreamPositionがIOExceptionをスローする場合。

      • mark

        public void mark()
        マーク付けされた位置のスタック上に現在のストリーム位置をプッシュします。
        定義:
        mark、インタフェースImageInputStream

      • reset

        public void reset()
           throws IOException
        マーク付けされた位置のスタックから現在のストリーム・バイトおよびビット位置をリセットします。

        以前にマーク付けされた位置がストリームの破棄された部分である場合にはIOExceptionがスローされます。

        定義:
        reset、インタフェースImageInputStream
        例外:
        IOException - 入出力エラーが発生した場合。

      • isCached

        public boolean isCached()
        デフォルトの実装ではfalseを返します。 サブクラスは、データをキャッシュに格納する場合はこれをオーバーライドする必要があります。
        定義:
        isCached、インタフェースImageInputStream
        戻り値:
        このImageInputStreamがデータをキャッシュに格納する場合はtrue。
        関連項目:
        ImageInputStream.isCachedMemory(), ImageInputStream.isCachedFile()

      • isCachedMemory

        public boolean isCachedMemory()
        デフォルトの実装ではfalseを返します。 サブクラスは、データをメイン・メモリーにキャッシュする場合はこれをオーバーライドする必要があります。
        定義:
        isCachedMemory、インタフェースImageInputStream
        戻り値:
        このImageInputStreamがデータをメイン・メモリーにキャッシュする場合はtrue。
        関連項目:
        ImageInputStream.isCached(), ImageInputStream.isCachedFile()

      • isCachedFile

        public boolean isCachedFile()
        デフォルトの実装ではfalseを返します。 サブクラスは、データを一時ファイルにキャッシュする場合はこれをオーバーライドする必要があります。
        定義:
        isCachedFile、インタフェースImageInputStream
        戻り値:
        このImageInputStreamがデータを一時ファイルにキャッシュする場合はtrue。
        関連項目:
        ImageInputStream.isCached(), ImageInputStream.isCachedMemory()

      • finalize

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