- java.lang.Object
-
- java.nio.channels.Pipe
-
public abstract class Pipe extends Object
A pair of channels that implements a unidirectional pipe.A pipe consists of a pair of channels: A writable
sinkchannel and a readablesourcechannel. 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.
- Since:
- 1.4
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classPipe.SinkChannelA channel representing the writable end of aPipe.static classPipe.SourceChannelA channel representing the readable end of aPipe.
-
Constructor Summary
Constructors Modifier Constructor Description protectedPipe()Initializes a new instance of this class.
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description static Pipeopen()Opens a pipe.abstract Pipe.SinkChannelsink()Returns this pipe's sink channel.abstract Pipe.SourceChannelsource()Returns this pipe's source channel.
-
-
-
Method Detail
-
source
public abstract Pipe.SourceChannel source()
Returns this pipe's source channel.- Returns:
- This pipe's source channel
-
sink
public abstract Pipe.SinkChannel sink()
Returns this pipe's sink channel.- Returns:
- This pipe's sink channel
-
open
public static Pipe open() throws IOException
Opens a pipe.The new pipe is created by invoking the
openPipemethod of the system-wide defaultSelectorProviderobject.- Returns:
- A new pipe
- Throws:
IOException- If an I/O error occurs
-
-