java.lang.Object
java.nio.channels.Pipe
A pair of channels that implements a unidirectional pipe.
A pipe consists of a pair of channels: A writable sink channel and a readable source
channel. 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 -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic Pipeopen()Opens a pipe.abstract Pipe.SinkChannelsink()Returns this pipe's sink channel.abstract Pipe.SourceChannelsource()Returns this pipe's source channel.
-
Constructor Details
-
Pipe
protected Pipe()Initializes a new instance of this class.
-
-
Method Details
-
source
Returns this pipe's source channel.- Returns:
- This pipe's source channel
-
sink
Returns this pipe's sink channel.- Returns:
- This pipe's sink channel
-
open
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
-