java.nio.channels.ScatteringByteChannel |
Known Indirect Subclasses |
The interface for channels that can read data into a set of buffers in a
single operation. The corresponding interface for writes is
GatheringByteChannel
.
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Attempts to read all
remaining() bytes from length byte
buffers, in order, starting at buffers[offset] . | |||||||||||
Reads bytes from this channel into the specified array of buffers.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
java.io.Closeable
| |||||||||||
From interface
java.lang.AutoCloseable
| |||||||||||
From interface
java.nio.channels.Channel
| |||||||||||
From interface
java.nio.channels.ReadableByteChannel
|
Attempts to read all remaining()
bytes from length
byte
buffers, in order, starting at buffers[offset]
. The number of
bytes actually read is returned.
If a read operation is in progress, subsequent threads will block until the read is completed and will then contend for the ability to read.
buffers | the array of byte buffers into which the bytes will be copied. |
---|---|
offset | the index of the first buffer to store bytes in. |
length | the maximum number of buffers to store bytes in. |
AsynchronousCloseException | if the channel is closed by another thread during this read operation. |
---|---|
ClosedByInterruptException | if another thread interrupts the calling thread while the operation is in progress. The interrupt state of the calling thread is set and the channel is closed. |
ClosedChannelException | if the channel is closed. |
IndexOutOfBoundsException | if offset < 0 or length < 0 , or if
offset + length is greater than the size of
buffers . |
IOException | if another I/O error occurs; details are in the message. |
NonWritableChannelException | if the channel has not been opened in a mode that permits reading. |
Reads bytes from this channel into the specified array of buffers.
This method is equivalent to read(buffers, 0, buffers.length);
buffers | the array of byte buffers to store the bytes being read. |
---|
AsynchronousCloseException | if the channel is closed by another thread during this read operation. |
---|---|
ClosedByInterruptException | if another thread interrupts the calling thread while the operation is in progress. The interrupt state of the calling thread is set and the channel is closed. |
ClosedChannelException | if the channel is closed. |
IOException | if another I/O error occurs; details are in the message. |
NonWritableChannelException | if the channel has not been opened in a mode that permits reading. |