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