javax.imageio.stream
クラス FileImageOutputStream

java.lang.Object
  javax.imageio.stream.ImageInputStreamImpl
      javax.imageio.stream.ImageOutputStreamImpl
          javax.imageio.stream.FileImageOutputStream

すべての実装されたインタフェース:

DataInput, DataOutput, ImageInputStream, ImageOutputStream

public class FileImageOutputStream
extends ImageOutputStreamImpl

出力を File または RandomAccessFile に直接書き込む ImageOutputStream の実装です。

フィールドの概要

クラス javax.imageio.stream.ImageInputStreamImpl から継承されたフィールド

bitOffset, byteOrder, flushedPos, streamPos

コンストラクタの概要

FileImageOutputStream(File f)
指定された File に書き込む FileImageOutputStream を構築します。

FileImageOutputStream(RandomAccessFile raf)
指定された RandomAccessFile に書き込む FileImageOutputStream を構築します。

メソッドの概要

void	close() ストリームを閉じます。
long	length() ストリームが未知の長さであることを示す -1L を返します。
int	read() ストリームから 1 バイトを読み込み、それを 0 から 255 までの整数として返します。
int	read(byte[] b, int off, int len) ストリームから len バイトまで読み込み、b にインデックス off から格納します。
void	seek(long pos) 現在のストリーム位置を設定してビットオフセットを 0 にリセットします。
void	write(byte[] b, int off, int len) 配列 b から len バイトを順番に出力ストリームに書き込みます。
void	write(int b) 引数 b の下位 8 ビットを出力ストリームに書き込みます。

クラス 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, finalize, flush, flushBefore, 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

クラス java.lang.Object から継承されたメソッド

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

インタフェース javax.imageio.stream.ImageOutputStream から継承されたメソッド

flushBefore

インタフェース 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

コンストラクタの詳細

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

インタフェース 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 - 入出力エラーが発生した場合

write

public void write(int b)
           throws IOException

インタフェース DataOutput の記述:

引数 b の下位 8 ビットを出力ストリームに書き込みます。b の上位 24 ビットについては無視されます。

定義:

インタフェース DataOutput 内の write

定義:

インタフェース ImageOutputStream 内の write

定義:

クラス ImageOutputStreamImpl 内の write

パラメータ:

b - 書き込むバイト

例外:

IOException - 入出力エラーが発生した場合

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException

インタフェース DataOutput の記述:

配列 b から len バイトを順番に出力ストリームに書き込みます。b が null の場合は、NullPointerException がスローされます。off が負の値の場合、len が負の値の場合、あるいは off+len が配列 b の長さより大きい場合には、IndexOutOfBoundsException がスローされます。len がゼロの場合、書き込まれるバイトはありません。そうでない場合は、まずバイト b[off]、次に b[off+1] と順次書き込まれ、最後にバイト b[off+len-1] が書き込まれます。

定義:

インタフェース DataOutput 内の write

定義:

インタフェース ImageOutputStream 内の write

定義:

クラス ImageOutputStreamImpl 内の write

パラメータ:

b - データ

off - データの開始オフセット

len - 書き込むバイト数

例外:

IOException - 入出力エラーが発生した場合

length

public long length()

クラス ImageInputStreamImpl の記述:

ストリームが未知の長さであることを示す -1L を返します。サブクラスでこのメソッドをオーバーライドして、実際の長さの情報を指定する必要があります。

定義:

インタフェース ImageInputStream 内の length

オーバーライド:

クラス ImageInputStreamImpl 内の length

戻り値:

未知の長さを示す -1L

seek

public void seek(long pos)
          throws IOException

現在のストリーム位置を設定してビットオフセットを 0 にリセットします。シークでファイルの終りを通過することは正常で、EOFException は読み込みの場合にのみスローされます。書き込みが実行されるまで、ファイル長は増加しません。

定義:

インタフェース ImageInputStream 内の seek

オーバーライド:

クラス ImageInputStreamImpl 内の seek

パラメータ:

pos - 目的のファイルポインタ位置を示す long

例外:

IndexOutOfBoundsException - pos がフラッシュ位置よりも小さい場合

IOException - その他の入出力エラーが発生した場合

close

public void close()
           throws IOException

インタフェース ImageInputStream の記述:

ストリームを閉じます。閉じたストリームにアクセスしようとすると、 IOException がスローされるか不正な動作が実行される場合があります。このメソッドを呼び出すと、このインタフェースを実装するクラスが、メモリ、ディスクスペース、またはファイル記述子などのストリームに関連するリソースを解放できます。

定義:

インタフェース ImageInputStream 内の close

オーバーライド:

クラス ImageInputStreamImpl 内の close

例外:

IOException - 入出力エラーが発生した場合