java.io
Class PipedWriter
java.lang.Object
|
+--java.io.Writer
|
+--java.io.PipedWriter
public class
PipedWriterextends
Writer This class writes its chars to a
PipedReader
to
which it is connected.
It is highly recommended that a PipedWriter
and its
connected PipedReader
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)
PipedWriter
public PipedWriter()
Create an unconnected PipedWriter. It must be connected
to a PipedReader
using the connect
method prior to writing any data or an exception will be thrown.
PipedWriter
public PipedWriter(java.io.PipedReader sink)
Create a new PipedWriter
instance
to write to the specified PipedReader
. This stream
is then ready for writing.
Parameters:
Throws:
IOException
- If sink
has already been connected
to a different PipedWriter.
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.PipedReader sink)
Connects this object to the specified PipedReader
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(char[] b, int off, int len)
This method writes len
chars of data from the char array
buf
starting at index offset
in the array
to the stream. Note that this method will block if the
PipedReader
to which this object is connected has
a buffer that cannot hold all of the chars 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 char of date to the stream. Note that this method will
block if the PipedReader
to which this object is
connected has a full buffer.
Parameters:
Throws:
IOException
- If the stream has not been connected or has
been closed.
PipedReader
to which it is connected.It is highly recommended that a
PipedWriter
and its connectedPipedReader
be in different threads. If they are in the same thread, read and write operations could deadlock the thread.