|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.io.OutputStream java.io.PipedOutputStream
public class PipedOutputStream
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.
PipedInputStream
Constructor Summary | |
---|---|
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. |
Method Summary | |
---|---|
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. |
Methods inherited from class java.io.OutputStream |
---|
write |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public PipedOutputStream(PipedInputStream snk) throws IOException
snk
.
snk
- The piped input stream to connect to.
IOException
- if an I/O error occurs.public PipedOutputStream()
PipedInputStream.connect(java.io.PipedOutputStream)
,
connect(java.io.PipedInputStream)
Method Detail |
---|
public void connect(PipedInputStream snk) throws 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.
IOException
- if an I/O error occurs.public void write(int b) throws IOException
byte
to the piped output stream.
Implements the write
method of OutputStream
.
write
in class OutputStream
b
- the byte
to be written.
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 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 OutputStream
b
- the data.off
- the start offset in the data.len
- the number of bytes to write.
IOException
- if the pipe is broken,
unconnected
,
closed, or if an I/O error occurs.public void flush() throws IOException
flush
in interface Flushable
flush
in class OutputStream
IOException
- if an I/O error occurs.public void close() throws IOException
close
in interface Closeable
close
in class OutputStream
IOException
- if an I/O error occurs.
|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.