java.nio.channels

Интерфейсный ScatteringByteChannel

Все Суперинтерфейсы:

AutoCloseable, Канал, Closeable, ReadableByteChannel

Все Известные Классы с реализацией:

DatagramChannel, FileChannel, Канал. SourceChannel, SocketChannel

public interface ScatteringByteChannel
extends ReadableByteChannel

Канал, который может считать байты в последовательность буферов.

Рассеивающаяся операция чтения читает, в единственном вызове, последовательности байтов в один или большем количестве данной последовательности буферов. Рассеивающиеся чтения часто полезны, реализовывая сетевые протоколы или форматы файлов что, например, групповые данные в сегменты, состоящие из одного или более заголовков фиксированной длины, сопровождаемых телом переменной длины. Подобные сборочные операции записи определяются в GatheringByteChannel интерфейс.

С тех пор:

1.4

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
long	read(ByteBuffer[] dsts) Читает последовательность байтов от этого канала в данные буферы.
long	read(ByteBuffer[] dsts, int offset, int length) Читает последовательность байтов от этого канала в подпоследовательность данных буферов.

Методы, наследованные от интерфейса java.nio.channels. ReadableByteChannel

читать

Методы, наследованные от интерфейса java.nio.channels. Канал

close, isOpen

Деталь метода

читать

long read(ByteBuffer[] dsts,
        int offset,
        int length)
          throws IOException

Читает последовательность байтов от этого канала в подпоследовательность данных буферов.

Вызов этого метода пытается читать до r байтов из этого канала, где r является общим количеством байтов, остающихся указанной подпоследовательностью данного буферного массива, то есть,

 dsts[offset].remaining()
     + dsts[offset+1].remaining()
     + ... + dsts[offset+length-1].remaining()

в настоящее время то, что этот метод вызывается.

Предположите, что последовательность байта длины n читается, где 0 <= n <= r. До первых байтов dsts[offset].remaining() этой последовательности передаются в буферный dsts[offset], до следующего dsts[offset+1].remaining(), байты передаются в буферный dsts[offset+1], и т.д, пока вся последовательность байта не передается в данные буферы. Так много байтов насколько возможно передаются в каждый буфер, следовательно заключительная позиция каждого обновленного буфера, кроме последнее обновление буфера, как гарантируют, будет равна пределу того буфера.

В любое время может быть вызван этот метод. Если другой поток уже инициировал операцию чтения на этот канал, однако, то вызов этого метода блокирует, пока первая работа не полна.

Параметры:

dsts - Буферы, в которые должны быть переданы байты

offset - Смещение в пределах буферного массива первого буфера, в который должны быть переданы байты; должно быть неотрицательным и не больше чем dsts.length

length - Максимальное количество буферов, которые будут получены доступ; должно быть неотрицательным и не больше чем dsts.length - offset

Возвраты:

Число байтов считало, возможно обнуляет, или -1, если канал достиг конца потока

Броски:

IndexOutOfBoundsException - Если предварительные условия на offset и параметрах length не содержат

NonReadableChannelException - Если этот канал не был открыт для того, чтобы читать

ClosedChannelException - Если этот канал закрывается

AsynchronousCloseException - Если другой поток закрывает этот канал, в то время как операция чтения происходит

ClosedByInterruptException - Если другой поток прерывает текущий поток, в то время как операция чтения происходит, таким образом закрывая канал и устанавливая состояние прерывания текущего потока

IOException - Если некоторая другая ошибка ввода-вывода происходит

читать

long read(ByteBuffer[] dsts)
          throws IOException

Читает последовательность байтов от этого канала в данные буферы.

Вызов этого метода формы c.read(dsts) ведет себя точно тем же самым способом как вызов

 c.read(dsts, 0, dsts.length);

Параметры:

dsts - Буферы, в которые должны быть переданы байты

Возвраты:

Число байтов считало, возможно обнуляет, или -1, если канал достиг конца потока

Броски:

NonReadableChannelException - Если этот канал не был открыт для того, чтобы читать

ClosedChannelException - Если этот канал закрывается

AsynchronousCloseException - Если другой поток закрывает этот канал, в то время как операция чтения происходит

ClosedByInterruptException - Если другой поток прерывает текущий поток, в то время как операция чтения происходит, таким образом закрывая канал и устанавливая состояние прерывания текущего потока

IOException - Если некоторая другая ошибка ввода-вывода происходит