java.io.BufferedOutputStream
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.
Summary
Fields
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 . |
Public Constructors
Public Methods
|
synchronized |
|
|
|
void |
flush() |
|
synchronized |
|
|
|
void |
write(int oneByte) |
|
synchronized |
|
|
|
void |
write(byte[] buffer, int offset, int length) |
|
|
|
|
|
void |
close() |
|
|
|
|
|
void |
flush() |
|
|
|
|
|
void |
write(byte[] buffer) |
abstract |
|
|
|
|
void |
write(int oneByte) |
|
|
|
|
|
void |
write(byte[] buffer, int offset, int count) |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Details
Fields
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
.
Public Constructors
public
BufferedOutputStream(OutputStream out)
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.
|
public
BufferedOutputStream(OutputStream out, int size)
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. |
size
| the size of the buffer in bytes. |
Public Methods
public
synchronized
void
flush()
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 this
BufferedOutputStream.
|
public
synchronized
void
write(int oneByte)
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 this
BufferedOutputStream.
|
public
synchronized
void
write(byte[] buffer, int offset, int length)
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 |
offset
| offset in buffer to get bytes |
length
| number of bytes in buffer to write |