java.nio.channels

Интерфейсный WritableByteChannel

Все Суперинтерфейсы:

AutoCloseable, Канал, Closeable

Все Известные Подынтерфейсы:

ByteChannel, GatheringByteChannel, SeekableByteChannel

Все Известные Классы с реализацией:

DatagramChannel, FileChannel, Канал. SinkChannel, SocketChannel

public interface WritableByteChannel
extends Channel

Канал, который может записать байты.

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

С тех пор:

1.4

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
int	write(ByteBuffer src) Пишет последовательность байтов к этому каналу от данного буфера.

Методы, наследованные от интерфейса java.nio.channels. Канал

close, isOpen

Деталь метода

записать

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 - Если некоторая другая ошибка ввода-вывода происходит