Интерфейс 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 вызывается для отмены операций чтения или записи, рекомендуется отбрасывать все буферы, использованные в этих операциях ввода-вывода, либо следить за тем, чтобы к буферам не обращались, пока канал остаётся открытым.