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