Class: java.io.PipedOutputStream
- public class PipedOutputStream
- extends OutputStream
A piped output stream can be connected to a piped input stream
to create a communications pipe. The piped output stream is the
sending end of the pipe. Typically, data is written to a
PipedOutputStream object by one thread and data is
read from the connected PipedInputStream by some
other thread. Attempting to use both objects from a single thread
is not recommended as it may deadlock the thread.
The pipe is said to be broken if a
thread that was reading data bytes from the connected piped input
stream is no longer alive.Inheritance
Superclass tree:- java.lang.Object
- java.io.OutputStream
- java.io.PipedOutputStream
Methods
-
PipedOutputStreamtop
public PipedOutputStream()Creates a piped output stream that is not yet connected to a piped input stream. It must be connected to a piped input stream, either by the receiver or the sender, before being used. -
PipedOutputStreamtop
public PipedOutputStream(PipedInputStream snk) throws IOExceptionCreates a piped output stream connected to the specified piped input stream. Data bytes written to this stream will then be available as input fromsnk. -
closetop
public void close() throws IOExceptionCloses this piped output stream and releases any system resources associated with this stream. This stream may no longer be used for writing bytes.- Override hierarchy:
- close from OutputStream
-
connecttop
public synchronized void connect(PipedInputStream snk) throws IOExceptionConnects this piped output stream to a receiver. If this object is already connected to some other piped input stream, anIOExceptionis thrown.If
snkis an unconnected piped input stream andsrcis an unconnected piped output stream, they may be connected by either the call:
or the call:src.connect(snk)
The two calls have the same effect.snk.connect(src)
-
flushtop
public synchronized void flush() throws IOExceptionFlushes this output stream and forces any buffered output bytes to be written out. This will notify any readers that bytes are waiting in the pipe.- Override hierarchy:
- flush from OutputStream
-
writetop
public void write(int b) throws IOExceptionWrites the specifiedbyteto the piped output stream.Implements the
writemethod ofOutputStream.- Override hierarchy:
- write from OutputStream
-
writetop
public void write(byte[] b, int off, int len) throws IOExceptionWriteslenbytes from the specified byte array starting at offsetoffto this piped output stream. This method blocks until all the bytes are written to the output stream.- Override hierarchy:
- write from OutputStream