Интерфейс 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);