22.19

java.io.FilterOutputStream

THE PACKAGE JAVA.IO

22.19 The Class

java.io.FilterOutputStream

A

FilterOutputStream

 contains some other output stream, which it uses as its

basic sink of data, possibly transforming the data along the way or providing addi 

tional functionality. The class

FilterOutputStream

 itself simply overrides all

methods of

OutputStream

 with versions that pass all requests to the contained

output stream. Subclasses of

FilterOutputStream

 may further override some of

these methods and may also provide additional methods and fields.

public class FilterOutputStream extends OutputStream {

protected OutputStream out;

public FilterOutputStream(OutputStream out);

public void write(int b) throws IOException;

public void write(byte[] b)

throws IOException, NullPointerException;

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

throws IOException, NullPointerException,

IndexOutOfBoundsException;

public void flush() throws IOException;

public void close() throws IOException;

}

22.19.1

protected OutputStream out;

The output stream to be filtered.

22.19.2

public FilterOutputStream(OutputStream out)

This constructor initializes a newly created

FilterInputStream

 by assigning the

argument

out

 to the field

this.out

 so as to remember it for later use.

22.19.3

public void write(int b) throws IOException

This method simply performs

out.write(b)

.

Implements the abstract

write

 method of

OutputStream

 ( 22.15.1).

22.19.4

public void write(byte[] b)

throws IOException, NullPointerException

This method simply performs

out.write(b)

.

Overrides the

write

 method of

OutputStream

 ( 22.15.2).

730