Интерфейс WritableByteChannel

int write(ByteBuffer src) throws IOException

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

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

Предположим, что записана последовательность байтов длиной n, где 0 <= n <= r. Эта последовательность байтов будет передана из буфера, начиная с индекса p, где p — позиция буфера в момент вызова этого метода; индекс последнего записанного байта будет p + n - 1. После возврата позиция буфера будет равна p + n; его предел не изменится.

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

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