java.lang.Object
javax.imageio.stream.ImageInputStreamImpl
javax.imageio.stream.ImageOutputStreamImpl
javax.imageio.stream.FileImageOutputStream
- すべての実装されたインタフェース:
Closeable
,DataInput
,DataOutput
,AutoCloseable
,ImageInputStream
,ImageOutputStream
public class FileImageOutputStream extends ImageOutputStreamImpl
出力を
File
またはRandomAccessFile
に直接書き込むImageOutputStream
の実装です。-
フィールドのサマリー
クラス javax.imageio.stream.ImageInputStreamImplで宣言されたフィールド
bitOffset, byteOrder, flushedPos, streamPos
-
コンストラクタのサマリー
コンストラクタ説明指定されたFile
に書き込むFileImageOutputStream
を構築します。指定されたRandomAccessFile
に書き込むFileImageOutputStream
を構築します。 -
メソッドのサマリー
修飾子と型メソッド説明void
close()
ストリームを閉じます。protected void
finalize()
非推奨。long
length()
ストリームが未知の長さであることを示す-1L
を返します。int
read()
ストリームから1バイトを読み込み、それを0から255までのint
として返します。int
read(byte[] b, int off, int len)
ストリームから最大len
バイトを読み込み、b
にインデックスoff
から格納します。void
seek(long pos)
現在のストリーム位置を設定してビット・オフセットを0にリセットします。void
write(byte[] b, int off, int len)
バイトのシーケンスをストリームの現在位置に書き込みます。void
write(int b)
ストリームの現在の位置に1バイト書き込みます。クラス javax.imageio.stream.ImageOutputStreamImplで宣言されたメソッド
flushBits, write, writeBit, writeBits, writeBoolean, writeByte, writeBytes, writeChar, writeChars, writeChars, writeDouble, writeDoubles, writeFloat, writeFloats, writeInt, writeInts, writeLong, writeLongs, writeShort, writeShorts, writeUTF
クラス javax.imageio.stream.ImageInputStreamImplで宣言されたメソッド
checkClosed, close, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, 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, setBitOffset, setByteOrder, skipBytes, skipBytes
クラス java.lang.Objectで宣言されたメソッド
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
インタフェース javax.imageio.stream.ImageInputStreamで宣言されたメソッド
flush, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, 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, setBitOffset, setByteOrder, skipBytes, skipBytes
インタフェース javax.imageio.stream.ImageOutputStreamで宣言されたメソッド
flushBefore
-
コンストラクタの詳細
-
FileImageOutputStream
public FileImageOutputStream(File f) throws FileNotFoundException, IOException指定されたFile
に書き込むFileImageOutputStream
を構築します。- パラメータ:
f
- 書込み先のFile
。- 例外:
IllegalArgumentException
-f
がnull
の場合。SecurityException
- セキュリティ・マネージャが存在し、ファイルへの書込みアクセスが許可されない場合。FileNotFoundException
-f
が通常のファイルを示さないか、ほかの何らかの理由で読み込みおよび書込み用に開くことができない場合。IOException
- 入出力エラーが発生した場合。
-
FileImageOutputStream
public FileImageOutputStream(RandomAccessFile raf)指定されたRandomAccessFile
に書き込むFileImageOutputStream
を構築します。- パラメータ:
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
- 入出力エラーが発生した場合。
-
write
public void write(int b) throws IOExceptionインタフェースからコピーされた説明:ImageOutputStream
ストリームの現在の位置に1バイト書き込みます。b
の上位24ビットは無視されます。ストリーム内のビット・オフセットがゼロでない場合、現在のバイトの残りは0でパディングされ、最初に書き込まれます。 書込み後は、ビット・オフセットは0です。 実装側は、
ImageOutputStreamImpl
のflushBits
メソッドを使用してこれを保証できます。- パラメータ:
b
- 下位8ビットが書き込まれるint
。- 例外:
IOException
- 入出力エラーが発生した場合。
-
write
public void write(byte[] b, int off, int len) throws IOExceptionインタフェースからコピーされた説明:ImageOutputStream
バイトのシーケンスをストリームの現在位置に書き込みます。len
が0の場合、何も書き込みません。 バイトb[off]
を最初に書き込み、次にバイトb[off+1]
を書き込む、という具合になります。ストリーム内のビット・オフセットがゼロでない場合、現在のバイトの残りは0でパディングされ、最初に書き込まれます。 書込み後は、ビット・オフセットは0です。 実装側は、
ImageOutputStreamImpl
のflushBits
メソッドを使用してこれを保証できます。- パラメータ:
b
- 書き込まれるbyte
配列。off
- データの開始オフセット。len
- 書き込むbyte
数。- 例外:
IOException
- 入出力エラーが発生した場合。
-
length
public long length()クラスからコピーされた説明:ImageInputStreamImpl
ストリームが未知の長さであることを示す-1L
を返します。 サブクラスでこのメソッドをオーバーライドして、実際の長さの情報を指定する必要があります。- 定義:
length
、インタフェース:ImageInputStream
- オーバーライド:
length
、クラス:ImageInputStreamImpl
- 戻り値:
- 未知の長さを示す -1L
-
seek
public void seek(long pos) throws IOException現在のストリーム位置を設定してビット・オフセットを0にリセットします。 シークでファイルの終わりを通過することは正常であり、EOFException
は読込みの場合のみスローされます。 書込みが実行されるまで、ファイル長は増加しません。- パラメータ:
pos
- 目的のファイル・ポインタ位置を示すlong
。- 例外:
IndexOutOfBoundsException
-pos
がフラッシュ位置よりも小さい場合。IOException
- その他の入出力エラーが発生した場合。
-
close
public void close() throws IOExceptionインタフェースからコピーされた説明:ImageInputStream
ストリームを閉じます。 閉じたストリームにアクセスしようとすると、IOException
がスローされるか不正な動作が実行される場合があります。 このメソッドを呼び出すと、このインタフェースを実装するクラスが、メモリー、ディスク・スペース、またはファイル記述子などのストリームに関連するリソースを解放できます。- 例外:
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
-
finalize
メソッドは推奨されていません。