java.io
クラス FilterOutputStream

java.lang.Object
  java.io.OutputStream
      java.io.FilterOutputStream

直系の既知のサブクラス:

BufferedOutputStream, DataOutputStream, PrintStream

public class FilterOutputStream
extends OutputStream

FilterOutputStream は別の出力ストリームをデータシンクとして内部に保持して、そのストリームにデータを書き込む前に変換したりなにか別の機能を追加したりするためのクラスです。

FilterOutputStream クラスの実装は単に OutputStream のすべてのメソッドをオーバーライドして、メソッドに要求されるすべての処理を、保持している出力ストリームに要求するだけです。 FilterOutputStream のサブクラスでこれらのメソッドをさらにオーバーライドする、または別のメソッドやフィールドを追加します。

コンストラクタの概要

FilterOutputStream(OutputStream out)
指定された出力ストリームを出力先とする、 FilterOutputStream を生成します。

メソッドの概要

void	close() この出力ストリームをクローズして、ストリームに関連するシステムリソースを解放します。
void	flush() この出力ストリームをフラッシュして、バッファされた出力バイトデータを強制的に書き出します。
void	write(byte[] b) この出力ストリームに b.length バイトを書き込みます。
void	write(byte[] b, int off, int len) 指定されたバイト配列のインデックスオフセット off から格納されている len バイトのバイトデータを出力ストリームに書き込みます。
void	write(int b) 指定されたバイトデータをこの出力ストリームに書き込みます。

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

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

コンストラクタの詳細

FilterOutputStream

public FilterOutputStream(OutputStream out)

指定された出力ストリームを出力先とする、 FilterOutputStream を生成します。

パラメータ:

out - 内部の出力先として使用する出力ストリーム。 内部の出力先ストリームなしにインスタンスを生成する場合は null を指定します。

メソッドの詳細

close

public void close()
           throws IOException

この出力ストリームをクローズして、ストリームに関連するシステムリソースを解放します。

FilterOutputStream クラスの close メソッドの実装は、まず flush メソッドを呼び出したのち、内部の出力先ストリームの close メソッドを呼び出します。

オーバーライド:

クラス OutputStream 内の close

例外:

IOException - I/Oエラーが発生した場合

flush

public void flush()
           throws IOException

この出力ストリームをフラッシュして、バッファされた出力バイトデータを強制的に書き出します。

FilterOutputStream クラスの flush メソッドの実装は、単に内部の出力先ストリームの flush メソッドを呼び出します。

オーバーライド:

クラス OutputStream 内の flush

例外:

IOException - I/Oエラーが発生した場合

write

public void write(byte[] b)
           throws IOException

この出力ストリームに b.length バイトを書き込みます。

FilterOutputStream のこのメソッドの実装は write(b, 0, b.length) を呼び出します。 内部の出力先ストリームの write(int) を呼び出すのではないことに注意してください。

オーバーライド:

クラス OutputStream 内の write

パラメータ:

b - 書き込むデータ

例外:

IOException - I/Oエラーが発生した場合

関連項目:

OutputStream.write(byte[])

write

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

指定されたバイト配列のインデックスオフセット off から格納されている len バイトのバイトデータを出力ストリームに書き込みます。

FilterOutputStream のこのメソッドの実装は、内部の出力先ストリームの write(int) を繰り返して呼び出します。 内部の出力先ストリームの write(byte[], int, int) を呼び出すのではないことに注意してください。 FilterOutputStream のサブクラスではより性能のよい実装を提供することを推奨します。

オーバーライド:

クラス OutputStream 内の write

パラメータ:

b - 出力するデータを保持する配列

off - b 中の、出力するデータが格納されているオフセット

len - 出力するデータのバイト長

例外:

IOException - I/Oエラーが発生した場合

関連項目:

OutputStream.write(byte[])

write

public void write(int b)
           throws IOException

指定されたバイトデータをこの出力ストリームに書き込みます。

FilterOutputStream のこのメソッドの実装は内部の出力先ストリームの write(b) を呼び出します。

定義:

クラス OutputStream 内の write

パラメータ:

b - 出力する1バイト

例外:

IOException - I/Oエラーが発生した場合

関連項目:

OutputStream.write(int)