Интерфейс 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 возвращает количество записанных байтов.