Интерфейс GatheringByteChannel

long write(ByteBuffer[] srcs, int offset, int length) throws IOException

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

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

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

в момент вызова этого метода.

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

Если не указано иное, операция записи завершается только после записи всех r запрошенных байтов. Некоторые типы каналов в зависимости от их состояния могут записать только некоторые байты или, возможно, ни одного. Например, сокет-канал в режиме без блокировки не может записать больше байтов, чем свободны в буфере вывода сокета.

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

long write(ByteBuffer[] srcs) throws IOException

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

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

 c.write(srcs, 0, srcs.length);