| java.lang.Object
 java.io.OutputStream
java.io.FilterOutputStream
java.io.BufferedOutputStream
| BufferedOutputStream | | public class BufferedOutputStream extends FilterOutputStream (Code) | | BufferedOutputStream is a class which takes an output stream and
buffers the writes to that stream. In this way, costly interaction
with the original output stream can be minimized by writing buffered amounts
of data infrequently. The drawback is that extra space is required to hold
the buffer and copying takes place when writing that buffer.
See Also: BufferedInputStream |
| Field Summary | |
| protected byte[] | buf
The buffer containing the bytes to be written to the target OutputStream. | | protected int | count
The total number of bytes inside the byte array buf. |
| Method Summary | |
| public synchronized void | flush()
Flush this BufferedOutputStream to ensure all pending data is written out
to the target OutputStream. | | public synchronized void | write(byte[] buffer, int offset, int length)
Writes count bytes from the byte array
buffer starting at offset to this
BufferedOutputStream. | | public synchronized void | write(int oneByte)
Writes the specified byte oneByte to this
BufferedOutputStream. |
| buf | | protected byte[] buf(Code) | | The buffer containing the bytes to be written to the target OutputStream.
|
| count | | protected int count(Code) | | The total number of bytes inside the byte array buf.
|
| BufferedOutputStream | | public BufferedOutputStream(OutputStream out)(Code) | | Constructs a new BufferedOutputStream on the OutputStream
out. The default buffer size (8Kb) is allocated and all
writes are now filtered through this stream.
Parameters:
out - the OutputStream to buffer writes on. |
| BufferedOutputStream | | public BufferedOutputStream(OutputStream out, int size)(Code) | | Constructs a new BufferedOutputStream on the OutputStream
out. The buffer size is set to size and
all writes are now filtered through this stream.
Parameters:
out - the OutputStream to buffer writes on.
Parameters:
size - the size of the buffer in bytes.
throws:
IllegalArgumentException - the size is <= 0 |
| flush | | public synchronized void flush() throws IOException(Code) | | Flush this BufferedOutputStream to ensure all pending data is written out
to the target OutputStream. In addition, the target stream is also
flushed.
throws:
IOException - If an error occurs attempting to flush thisBufferedOutputStream. |
| write | | public synchronized void write(byte[] buffer, int offset, int length) throws IOException(Code) | | Writes count bytes from the byte array
buffer starting at offset to this
BufferedOutputStream. If there is room in the buffer to hold the bytes,
they are copied in. If not, the buffered bytes plus the bytes in
buffer are written to the target stream, the target is
flushed, and the buffer is cleared.
Parameters:
buffer - the buffer to be written
Parameters:
offset - offset in buffer to get bytes
Parameters:
length - number of bytes in buffer to write
throws:
IOException - If an error occurs attempting to write to thisBufferedOutputStream.
throws:
NullPointerException - If buffer is null.
throws:
ArrayIndexOutOfBoundsException - If offset or count is outside of bounds. |
| write | | public synchronized void write(int oneByte) throws IOException(Code) | | Writes the specified byte oneByte to this
BufferedOutputStream. Only the low order byte of oneByte
is written. If there is room in the buffer, the byte is copied in and the
count incremented. Otherwise, the buffer plus oneByte are
written to the target stream, the target is flushed, and the buffer is
reset.
Parameters:
oneByte - the byte to be written
throws:
IOException - If an error occurs attempting to write to thisBufferedOutputStream. |
|
|