| java.nio.channels.ScatteringByteChannel
All known Subclasses: java.nio.channels.SocketChannel, java.nio.channels.FileChannel, java.nio.channels.DatagramChannel,
| ScatteringByteChannel | | public interface ScatteringByteChannel extends ReadableByteChannel(Code) | | The interface to channels that can read a set of buffers in a single
operation.
The corresponding interface for writes is called
GatheringByteChannel.
|
| Method Summary | |
| public long | read(ByteBuffer[] buffers)
Reads bytes from the channel into all the given buffers.
This method is equivalent to:
read(buffers, 0, buffers.length);
Parameters:
buffers - the array of byte buffers to receive the bytes being read. | | public long | read(ByteBuffer[] buffers, int offset, int length)
Reads bytes from the channel into a subset of the given buffers.
This method attempts to read all of the remaining() bytes
from length byte buffers, in order, starting at
buffers[offset]. |
| read | | public long read(ByteBuffer[] buffers) throws IOException(Code) | | Reads bytes from the channel into all the given buffers.
This method is equivalent to:
read(buffers, 0, buffers.length);
Parameters:
buffers - the array of byte buffers to receive the bytes being read. the number of bytes actually read.
throws:
ClosedChannelException - if the channel is closed.
throws:
NonReadableChannelException - if the channel is open, but not in a mode that permitsreading.
throws:
ClosedByInterruptException - if the thread is interrupted in its IO operation by anotherthread closing the channel.
throws:
AsynchronousCloseException - if the read is interrupted by another thread sending anexplicit interrupt.
throws:
IOException - if some other type of exception occurs. Details are in themessage. |
| read | | public long read(ByteBuffer[] buffers, int offset, int length) throws IOException(Code) | | Reads bytes from the channel into a subset of the given buffers.
This method attempts to read all of the 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.
Parameters:
buffers - the array of byte buffers into which the bytes will be read.
Parameters:
offset - the index of the first buffer to read.
Parameters:
length - the maximum number of buffers to read. the number of bytes actually read.
throws:
IndexOutOfBoundsException - if offset < 0 or > buffers.length; or length < 0 or >buffers.length - offset.
throws:
NonReadableChannelException - if the channel was not opened for reading.
throws:
ClosedChannelException - the channel is currently closed.
throws:
AsynchronousCloseException - the channel was closed by another thread while the write wasunderway.
throws:
ClosedByInterruptException - the thread was interrupted by another thread while the writewas underway.
throws:
IOException - if some other type of exception occurs. Details are in themessage. |
|
|