java.io
Class PipedOutputStream
java.lang.Object
|
+--java.io.OutputStream
|
+--java.io.PipedOutputStream
This class writes its bytes to a
PipedInputStream
to
which it is connected.
It is highly recommended that a PipedOutputStream
and its
connected PipedInputStream
be in different threads. If
they are in the same thread, read and write operations could deadlock
the thread.
Author:- Aaron M. Renn (arenn@urbanophile.com)
PipedOutputStream
public PipedOutputStream()
Create an unconnected PipedOutputStream. It must be connected
to a PipedInputStream
using the connect
method prior to writing any data or an exception will be thrown.
PipedOutputStream
public PipedOutputStream(java.io.PipedInputStream sink)
Create a new PipedOutputStream
instance
to write to the specified PipedInputStream
. This stream
is then ready for writing.
Parameters:
Throws:
IOException
- If sink
has already been connected
to a different PipedOutputStream.
close
public void close()
This method closes this stream so that no more data can be written
to it. Any further attempts to write to this stream may throw an
exception
Throws:
connect
public void connect(java.io.PipedInputStream sink)
Connects this object to the specified PipedInputStream
object. This stream will then be ready for writing.
Parameters:
Throws:
IOException
- If the stream has not been connected or has
been closed.
flush
public void flush()
This method does nothing.
Throws:
write
public void write(byte[] b, int off, int len)
This method writes len
bytes of data from the byte array
buf
starting at index offset
in the array
to the stream. Note that this method will block if the
PipedInputStream
to which this object is connected has
a buffer that cannot hold all of the bytes to be written.
Parameters:
Throws:
IOException
- If the stream has not been connected or has
been closed.
write
public void write(int b)
Write a single byte of date to the stream. Note that this method will
block if the PipedInputStream
to which this object is
connected has a full buffer.
Parameters:
Throws:
IOException
- If the stream has not been connected or has
been closed.
PipedInputStream
to which it is connected.It is highly recommended that a
PipedOutputStream
and its connectedPipedInputStream
be in different threads. If they are in the same thread, read and write operations could deadlock the thread.