クラスFilterOutputStream
java.lang.Object
java.io.OutputStream
java.io.FilterOutputStream
- すべての実装されたインタフェース:
Closeable,Flushable,AutoCloseable
- 直系の既知のサブクラス:
BufferedOutputStream,CheckedOutputStream,CipherOutputStream,DataOutputStream,DeflaterOutputStream,DigestOutputStream,InflaterOutputStream,PrintStream
public class FilterOutputStream extends OutputStream
このクラスは、出力ストリームをフィルタ処理するすべてのクラスのスーパー・クラスです。 これらのストリームは、データの基本のシンクとして使用するための既存の出力ストリーム(ベースとなる出力ストリーム)の最上位にあります。ただし、データを途中で変換することや、追加機能を提供することもあります。
FilterOutputStreamクラスそのものが、ベースとなる出力ストリームにすべての要求を渡すバージョンによって、OutputStreamのすべてのメソッドを単純にオーバーライドします。 FilterOutputStreamのサブクラスは、これらのメソッドの一部をさらにオーバーライドすることができ、追加のメソッドやフィールドを提供することもできます。
- 導入されたバージョン:
- 1.0
-
フィールドのサマリー
フィールド -
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明voidclose()出力ストリームを閉じ、これに関連するすべてのシステム・リソースを解放します。voidflush()出力ストリームをフラッシュして、バッファリングされていたすべての出力バイトを強制的にストリームに書き込みます。voidwrite(byte[] b) b.lengthバイトのデータをこの出力ストリームに書き込みます。voidwrite(byte[] b, int off, int len) 指定されたbyte配列のオフセット位置offから始まるlenバイトをこの出力ストリームに書き込みます。voidwrite(int b) 指定されたbyteをこの出力ストリームに書き込みます。クラスjava.io.OutputStreamで宣言されたメソッド
nullOutputStream
-
フィールド詳細
-
out
protected OutputStream outフィルタ処理されるベースとなる出力ストリームです。
-
-
コンストラクタの詳細
-
FilterOutputStream
public FilterOutputStream(OutputStream out) 指定されたベースとなる出力ストリームの上位に出力ストリーム・フィルタを作成します。- パラメータ:
out- 後で使用するためにフィールドthis.outに割り当てる基礎となる出力ストリーム、または基礎となるストリームなしでこのインスタンスを作成する場合はnull。
-
-
メソッドの詳細
-
write
public void write(int b) throws IOException 指定されたbyteをこの出力ストリームに書き込みます。FilterOutputStreamのwriteメソッドは、基礎となる出力ストリームのwriteメソッドをコールします。つまり、out.write(b)を実行します。OutputStreamの抽象writeメソッドを実装します。- 定義:
write、クラスOutputStream- パラメータ:
b-byte。- スロー:
IOException- 入出力エラーが発生した場合。
-
write
public void write(byte[] b) throws IOException b.lengthバイトのデータをこの出力ストリームに書き込みます。- オーバーライド:
write、クラスOutputStream- 実装要件:
FilterOutputStreamのwriteメソッドは、3つの引数をとるwriteメソッドに引数b、0、およびb.lengthを指定して呼び出します。- 実装上のノート:
- このメソッドは、単一の引数
bを使用して、基本となる出力ストリームの1引数のwriteメソッドを呼び出さないことに注意してください。 - パラメータ:
b- 書き込まれるデータ。- スロー:
IOException- 入出力エラーが発生した場合。- 関連項目:
-
write
public void write(byte[] b, int off, int len) throws IOException 指定されたbyte配列のオフセット位置offから始まるlenバイトをこの出力ストリームに書き込みます。- オーバーライド:
write、クラスOutputStream- 実装要件:
FilterOutputStreamのwriteは、出力する各byteに対して、1つの引数をとるwriteメソッドを呼び出します。- 実装上のノート:
- このメソッドは、基礎となる出力ストリームの
writeメソッドを同じ引数でコールしません。FilterOutputStreamのサブクラスでは、このメソッドをより効率的に実装してください。 - パラメータ:
b- データ。off- データの開始オフセット。len- 書き込むバイト数。- スロー:
IOException- 入出力エラーが発生した場合。IndexOutOfBoundsException-offが負の値の場合、lenが負の値の場合、あるいはlenがb.length - offより大きい場合- 関連項目:
-
flush
public void flush() throws IOException出力ストリームをフラッシュして、バッファリングされていたすべての出力バイトを強制的にストリームに書き込みます。- 定義:
flush、インタフェースFlushable- オーバーライド:
flush、クラスOutputStream- 実装要件:
FilterOutputStreamのflushメソッドはそのベースとなる出力ストリームのflushメソッドを呼び出します。- スロー:
IOException- 入出力エラーが発生した場合。- 関連項目:
-
close
public void close() throws IOException出力ストリームを閉じ、これに関連するすべてのシステム・リソースを解放します。- 定義:
close、インタフェースAutoCloseable- 定義:
close、インタフェースCloseable- オーバーライド:
close、クラスOutputStream- 実装要件:
- まだ閉じていない場合、
FilterOutputStreamのcloseメソッドは、そのflushメソッドをコールし、その基礎となる出力ストリームのcloseメソッドをコールします。 - スロー:
IOException- 入出力エラーが発生した場合。- 関連項目:
-