|
| |
|
| java.lang.Object
 java.io.OutputStream
java.io.PipedOutputStream
| PipedOutputStream | | public class PipedOutputStream extends OutputStream (Code) | | PipedOutputStream is a class which places information on a communications
pipe. When two threads want to pass data back and forth, one creates a piped
output stream and the other creates a piped input stream.
See Also: PipedInputStream |
| Method Summary | |
| public void | close()
Close this PipedOutputStream. | | public void | connect(PipedInputStream stream)
Connects this PipedOutputStream to a PipedInputStream. | | public void | flush()
Notifies the readers on the PipedInputStream that bytes can be read. | | public void | write(byte buffer, int offset, int count)
Writes count bytes from this byte array
buffer starting at offset index to this
PipedOutputStream. | | public void | write(int oneByte)
Writes the specified byte oneByte to this
PipedOutputStream. |
| PipedOutputStream | | public PipedOutputStream()(Code) | | Constructs a new unconnected PipedOutputStream. The resulting Stream must
be connected to a PipedInputStream before data may be written to it.
|
| PipedOutputStream | | public PipedOutputStream(PipedInputStream dest) throws IOException(Code) | | Constructs a new PipedOutputStream connected to the PipedInputStream
dest. Any data written to this stream can be read from
the dest.
Parameters:
dest - the PipedInputStream to connect to.
throws:
IOException - if dest is already connected. |
| close | | public void close() throws IOException(Code) | | Close this PipedOutputStream. Any data buffered in the corresponding
PipedInputStream can be read, then -1 will be returned to the reader. If
this OutputStream is not connected, this method does nothing.
throws:
IOException - If an error occurs attempting to close thisPipedOutputStream. |
| connect | | public void connect(PipedInputStream stream) throws IOException(Code) | | Connects this PipedOutputStream to a PipedInputStream. Any data written
to this OutputStream becomes readable in the InputStream.
Parameters:
stream - the destination PipedInputStream.
throws:
IOException - If this Stream or the dest is already connected. |
| flush | | public void flush() throws IOException(Code) | | Notifies the readers on the PipedInputStream that bytes can be read. This
method does nothing if this Stream is not connected.
throws:
IOException - If an IO error occurs during the flush. |
| write | | public void write(byte buffer, int offset, int count) throws IOException(Code) | | Writes count bytes from this byte array
buffer starting at offset index to this
PipedOutputStream. The written data can now be read from the destination
PipedInputStream. Separate threads should be used for the reader of the
PipedInputStream and the PipedOutputStream. There may be undesirable
results if more than one Thread interacts a input or output pipe.
Parameters:
buffer - the buffer to be written
Parameters:
offset - offset in buffer to get bytes
Parameters:
count - number of bytes in buffer to write
throws:
IOException - If the receiving thread was terminated without closing thepipe. This case is not currently handled correctly.
throws:
InterruptedIOException - If the pipe is full and the current thread is interruptedwaiting for space to write data. This case is not currentlyhandled correctly.
throws:
NullPointerException - If the receiver has not been connected yet.
throws:
IllegalArgumentException - If any of the arguments are out of bounds. |
| write | | public void write(int oneByte) throws IOException(Code) | | Writes the specified byte oneByte to this
PipedOutputStream. Only the low order byte of oneByte is
written. The data can now be read from the destination PipedInputStream.
Separate threads should be used for the reader of the PipedInputStream
and the PipedOutputStream. There may be undesirable results if more than
one Thread interacts a input or output pipe.
Parameters:
oneByte - the byte to be written
throws:
IOException - If the receiving thread was terminated without closing thepipe. This case is not currently handled correctly.
throws:
InterruptedIOException - If the pipe is full and the current thread is interruptedwaiting for space to write data. This case is not currentlyhandled correctly.
throws:
NullPointerException - If the receiver has not been connected yet. |
|
|
|