java.io

Class FilterOutputStream

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

All Implemented Interfaces:

Closeable, Flushable

Direct Known Subclasses:

BufferedOutputStream, DataOutputStream

public class FilterOutputStream
extends OutputStream

This class is the common superclass of output stream classes that filter the output they write. These classes typically transform the data in some way prior to writing it out to another underlying OutputStream. This class simply overrides all the methods in OutputStream to redirect them to the underlying stream. Subclasses provide actual filtering.

Author:

Aaron M. Renn (arenn@urbanophile.com), Tom Tromey (tromey@cygnus.com)

Constructor Summary

Constructors

Constructor and Description
FilterOutputStream(OutputStream out) This method initializes an instance of FilterOutputStream to write to the specified subordinate OutputStream.

Method Summary

Modifier and Type	Method and Description
void	close() This method closes the underlying OutputStream.
void	flush() This method attempt to flush all buffered output to be written to the underlying output sink.
void	write(byte[] buf) This method writes all the bytes in the specified array to the underlying OutputStream.
void	write(byte[] buf, int offset, int len) This method calls the write(int) method len times for all bytes from the array buf starting at index offset.
void	write(int b) This method writes a single byte of output to the underlying OutputStream.

Methods inherited from class java.lang.Object

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

Constructor Detail

FilterOutputStream

public FilterOutputStream(OutputStream out)

This method initializes an instance of FilterOutputStream to write to the specified subordinate OutputStream.

Parameters:

out - The OutputStream to write to

Method Detail

close

public void close()
           throws IOException

This method closes the underlying OutputStream. Any further attempts to write to this stream may throw an exception.

Specified by:

close in interface Closeable

Overrides:

close in class OutputStream

Throws:

IOException - If an error occurs

flush

public void flush()
           throws IOException

This method attempt to flush all buffered output to be written to the underlying output sink.

Specified by:

flush in interface Flushable

Overrides:

flush in class OutputStream

Throws:

IOException - If an error occurs

write

public void write(byte[] buf)
           throws IOException

This method writes all the bytes in the specified array to the underlying OutputStream. It does this by calling the three parameter version of this method - write(byte[], int, int) in this class instead of writing to the underlying OutputStream directly. This allows most subclasses to avoid overriding this method.

Overrides:

write in class OutputStream

Parameters:

buf - The byte array to write bytes from

Throws:

IOException - If an error occurs

write

public void write(byte[] buf,
                  int offset,
                  int len)
           throws IOException

This method calls the write(int) method len times for all bytes from the array buf starting at index offset. Subclasses should overwrite this method to get a more efficient implementation.

Overrides:

write in class OutputStream

Parameters:

buf - The byte array to write bytes from

offset - The index into the array to start writing bytes from

len - The number of bytes to write

Throws:

IOException - If an error occurs

write

public void write(int b)
           throws IOException

This method writes a single byte of output to the underlying OutputStream.

Specified by:

write in class OutputStream

Parameters:

b - The byte to write, passed as an int.

Throws:

IOException - If an error occurs