Интерфейс WritableByteChannel

int write(ByteBuffer src) throws IOException

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

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

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

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

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