Contents | Prev | Next | Index

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 additional 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).

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

This method simply performs out.write(b, off, len).

Overrides the write method of OutputStream (§22.15.3).

22.19.6 public void flush() throws IOException

This method simply performs out.flush().

Overrides the flush method of OutputStream (§22.15.4).

22.19.7 public void close() throws IOException

This method simply performs out.close().

Overrides the close method of OutputStream (§22.15.5).

Contents | Prev | Next | Index

Java Language Specification (HTML generated by Suzette Pelouch on February 24, 1998)
Copyright © 1996 Sun Microsystems, Inc. All rights reserved
Please send any comments or corrections to doug.kramer@sun.com