Интерфейс AsynchronousChannel

public interface AsynchronousChannel extends Channel

Канал, поддерживающий асинхронные операции ввода-вывода. Операции асинхронного ввода-вывода обычно принимают одну из двух форм:

1. Future<V> operation(...)

2. void operation(... A attachment, CompletionHandler<V,? super A> handler)

где operation — имя операции ввода-вывода (например, чтение или запись), V — тип результата операции ввода-вывода, а A — тип объекта, присоединённого к операции ввода-вывода, для предоставления контекста при обработке результата. Присоединение важно в тех случаях, когда используется бессостоятельный CompletionHandler для обработки результатов многих операций ввода-вывода.

В первом случае можно использовать методы, определённые интерфейсом Future, чтобы проверить, завершена ли операция, дождаться её завершения и получить результат. Во втором случае при завершении или ошибке операции ввода-вывода вызывается CompletionHandler для обработки результата.

Канал, реализующий этот интерфейс, является закрываемым асинхронно: если операция ввода-вывода выполняется на канале, и вызывается метод close канала, то операция ввода-вывода завершается с исключением AsynchronousCloseException.

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

Отмена

Интерфейс Future определяет метод cancel для отмены выполнения. Это приводит к тому, что все потоки, ожидающие результата операции ввода-вывода, выбрасывают исключение CancellationException. Возможность отмены базовой операции ввода-вывода зависит от конкретной реализации и поэтому не оговаривается. В случае, когда отмена оставляет канал или связанный с ним объект в несогласованном состоянии, канал переходит в состояние ошибки, определённое реализацией, которое предотвращает дальнейшие попытки запуска операций ввода-вывода, аналогичных отменённой операции. Например, если операция чтения отменена, но реализация не может гарантировать, что байты не были прочитаны из канала, она устанавливает для канала состояние ошибки; дальнейшие попытки запуска операции read приведут к выбрасыванию неопределённого исключения времени выполнения. Аналогично, если операция записи отменена, но реализация не может гарантировать, что байты не были записаны в канал, последующие попытки запуска операции write завершатся с неопределённым исключением времени выполнения.

Если метод cancel вызывается с параметром mayInterruptIfRunning установленным в true, то операция ввода-вывода может быть прервана закрытием канала. В этом случае все потоки, ожидающие результата операции ввода-вывода, выбрасывают CancellationException, а любые другие операции ввода-вывода, ожидающие обработки на канале, завершаются с исключением AsynchronousCloseException.

При вызове метода cancel для отмены операций чтения или записи рекомендуется удалить все буферы, используемые в операциях ввода-вывода, или позаботиться о том, чтобы к буферам не было доступа, пока канал остаётся открытым.