java.io
Class BufferedOutputStream

java.lang.Object
  |
  +--java.io.OutputStream
        |
        +--java.io.FilterOutputStream
              |
              +--java.io.BufferedOutputStream

public class BufferedOutputStream

extends FilterOutputStream

A buffered output stream. This stream lets you write characters to a stream without causing a write every time. The data is first written into a buffer. Data is written to the actual stream only when the buffer is full, or when the stream is flushed.

Field Summary

protected byte[]	buf The buffer where data is stored.
protected int	count The number of bytes in the buffer.

Fields inherited from class java.io.FilterOutputStream

out

Constructor Summary

BufferedOutputStream(OutputStream out)
Creates a new buffered stream with a default buffer size.

BufferedOutputStream(OutputStream out, int size)
Creates a new buffered stream with the specified buffer size.

Method Summary

void	flush() Flushes the stream.
void	write(byte[] b, int off, int len) Writes a subarray of bytes.
void	write(int b) Writes a byte.

Methods inherited from class java.io.FilterOutputStream

close, write

Methods inherited from class java.lang.Object

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

Field Detail

buf

protected byte[] buf

The buffer where data is stored.

count

protected int count

The number of bytes in the buffer.

Constructor Detail

BufferedOutputStream

public BufferedOutputStream(OutputStream out)

Creates a new buffered stream with a default buffer size.

Parameters:

out - the output stream

BufferedOutputStream

public BufferedOutputStream(OutputStream out,
                            int size)

Creates a new buffered stream with the specified buffer size.

Parameters:

out - the output stream

size - the buffer size

Method Detail

write

public void write(int b)
           throws IOException

Writes a byte. This method will block until the byte is actually written.

Overrides:

write in class FilterOutputStream

Parameters:

b - the byte to be written

Throws:

IOException - If an I/O error has occurred.

write

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

Writes a subarray of bytes.

Overrides:

write in class FilterOutputStream

Parameters:

b - the data to be written

off - the start offset in the data

len - the number of bytes that are written

Throws:

IOException - If an I/O error has occurred.

flush

public void flush()
           throws IOException

Flushes the stream. This will write any buffered output bytes.

Overrides:

flush in class FilterOutputStream

Throws:

IOException - If an I/O error has occurred.