Интерфейс WritableByteChannel

Все суперинтерфейсы:: AutoCloseable, Channel, Closeable

Все известные подинтерфейсы:: ByteChannel, GatheringByteChannel, SeekableByteChannel

Все известные реализующие классы:: DatagramChannel, FileChannel, Pipe.SinkChannel, SocketChannel

public interface WritableByteChannel
extends Channel

Канал, позволяющий записывать байты.

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

С:: 1.4

Методы

Модификатор и тип	Метод	Описание
`int`	`write(ByteBuffer src)`	Записывает последовательность байтов в этот канал из заданного буфера.

Методы, объявленные в интерфейсе java.nio.channels.Channel

close, isOpen

Методы

write

int write(ByteBuffer src)
   throws IOException

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

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

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

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

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

Параметры:: src - Буфер, из которого необходимо извлечь байты
Возвращает:: Количество записанных байтов, возможно ноль
Исключения:: NonWritableChannelException - Если этот канал не был открыт для записи; ClosedChannelException - Если этот канал закрыт; AsynchronousCloseException - Если другой поток закрывает этот канал во время выполнения операции записи; ClosedByInterruptException - Если другой поток прерывает текущий поток во время выполнения операции записи, тем самым закрывая канал и устанавливая статус прерывания текущего потока; IOException - Если произошла какая-либо другая ошибка ввода-вывода