public abstract class Pipe extends ObjectA pair of channels that implements a unidirectional pipe.
A pipe consists of a pair of channels: A writable
sinkchannel and a readable
sourcechannel. Once some bytes are written to the sink channel they can be read from the source channel in exactly the order in which they were written.
Whether or not a thread writing bytes to a pipe will block until another thread reads those bytes, or some previously-written bytes, from the pipe is system-dependent and therefore unspecified. Many pipe implementations will buffer up to a certain number of bytes between the sink and source channels, but such buffering should not be assumed.
Nested Class Summary
Nested Classes Modifier and Type Class Description
Pipe.SinkChannelA channel representing the writable end of a
Pipe.SourceChannelA channel representing the readable end of a
Constructors Modifier Constructor Description
Pipe()Initializes a new instance of this class.
Modifier and Type Method Description
open()Opens a pipe.
sink()Returns this pipe's sink channel.
source()Returns this pipe's source channel.
public abstract Pipe.SourceChannel source()Returns this pipe's source channel.
- This pipe's source channel
public abstract Pipe.SinkChannel sink()Returns this pipe's sink channel.
- This pipe's sink channel
public static Pipe open() throws IOExceptionOpens a pipe.
The new pipe is created by invoking the
openPipemethod of the system-wide default
- A new pipe
IOException- If an I/O error occurs