public class PipedOutputStream
extends java.io.OutputStream
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.PipedInputStream
Constructor and Description |
---|
PipedOutputStream()
Creates a piped output stream that is not yet connected to a
piped input stream.
|
PipedOutputStream(PipedInputStream snk)
Creates a piped output stream connected to the specified piped
input stream.
|
Modifier and Type | Method and Description |
---|---|
void |
close()
Closes this piped output stream and releases any system resources
associated with this stream.
|
void |
connect(PipedInputStream snk)
Connects this piped output stream to a receiver.
|
void |
flush()
Flushes this output stream and forces any buffered output bytes
to be written out.
|
void |
write(byte[] b,
int off,
int len)
Writes
len bytes from the specified byte array
starting at offset off to this piped output stream. |
void |
write(int b)
Writes the specified
byte to the piped output stream. |
public PipedOutputStream(PipedInputStream snk) throws java.io.IOException
snk
.snk
- The piped input stream to connect to.java.io.IOException
- if an I/O error occurs.public PipedOutputStream()
public void connect(PipedInputStream snk) throws java.io.IOException
IOException
is thrown.
If snk
is an unconnected piped input stream and
src
is 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)
snk
- the piped input stream to connect to.java.io.IOException
- if an I/O error occurs.public void write(int b) throws java.io.IOException
byte
to the piped output stream.
Implements the write
method of OutputStream
.
write
in class java.io.OutputStream
b
- the byte
to be written.java.io.IOException
- if the pipe is broken,
unconnected
,
closed, or if an I/O error occurs.public void write(byte[] b, int off, int len) throws java.io.IOException
len
bytes from the specified byte array
starting at offset off
to this piped output stream.
This method blocks until all the bytes are written to the output
stream.write
in class java.io.OutputStream
b
- the data.off
- the start offset in the data.len
- the number of bytes to write.java.io.IOException
- if the pipe is broken,
unconnected
,
closed, or if an I/O error occurs.public void flush() throws java.io.IOException
flush
in interface java.io.Flushable
flush
in class java.io.OutputStream
java.io.IOException
- if an I/O error occurs.public void close() throws java.io.IOException
close
in interface java.io.Closeable
close
in interface java.lang.AutoCloseable
close
in class java.io.OutputStream
java.io.IOException
- if an I/O error occurs.