Интерфейс AsynchronousByteChannel

<A> void read(ByteBuffer dst, A attachment, CompletionHandler<Integer,? super A> handler)

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

Этот метод инициирует асинхронную операцию чтения, чтобы прочитать последовательность байтов из этого канала в указанный буфер. Параметр handler — это обработчик завершения, который вызывается по завершении (или при ошибке) операции чтения. Результат, переданный обработчику завершения, — это количество прочитанных байтов или -1, если байты не могли быть прочитаны, потому что канал достиг конца потока.

Операция чтения может прочитать до r байтов из канала, где r — количество оставшихся байтов в буфере, то есть dst.remaining() в момент попытки чтения. Если r равно 0, операция чтения завершается немедленно с результатом 0 без инициализации операции ввода-вывода.

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

Буферы не являются потокобезопасными, поэтому следует позаботиться о том, чтобы не обращаться к буферу до завершения операции.

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

Future<Integer> read(ByteBuffer dst)

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

Этот метод инициирует асинхронную операцию чтения, чтобы прочитать последовательность байтов из этого канала в указанный буфер. Метод работает точно так же, как метод read(ByteBuffer,Object,CompletionHandler), за исключением того, что вместо указания обработчика завершения, этот метод возвращает Future представляющий ожидаемый результат. Метод get Future возвращает количество прочитанных байтов или -1 если байты не могли быть прочитаны, потому что канал достиг конца потока.

<A> void write(ByteBuffer src, A attachment, CompletionHandler<Integer,? super A> handler)

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

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

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

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

Буферы не являются потокобезопасными, поэтому следует позаботиться о том, чтобы не обращаться к буферу до завершения операции.

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

Future<Integer> write(ByteBuffer src)

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

Этот метод инициирует асинхронную операцию записи, чтобы записать последовательность байтов в этот канал из указанного буфера. Метод работает точно так же, как метод write(ByteBuffer,Object,CompletionHandler), за исключением того, что вместо указания обработчика завершения, этот метод возвращает Future представляющий ожидаемый результат. Метод get Future возвращает количество записанных байтов.