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

Методы

close

void close()
    throws IOException

Specified by:

close в интерфейсе AutoCloseable

Specified by:

close в интерфейсе Channel

Specified by:

close в интерфейсе Closeable

Throws:

IOException - Если произошла ошибка ввода-вывода