Интерфейс WritableByteChannel

int write(ByteBuffer src) throws IOException

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

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

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

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

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