java.nio.channels

Интерфейсный AsynchronousChannel

Все Суперинтерфейсы:

AutoCloseable, Канал, Closeable

Все Известные Подынтерфейсы:

AsynchronousByteChannel

Все Известные Классы с реализацией:

AsynchronousFileChannel, AsynchronousServerSocketChannel, AsynchronousSocketChannel

public interface AsynchronousChannel
extends Channel

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

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

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

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

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

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

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

Отмена

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

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

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

С тех пор:

1.7

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	close() Завершения этот канал.

Методы, наследованные от интерфейса java.nio.channels. Канал

isOpen

Деталь метода

близко

void close()
           throws IOException

Завершения этот канал.

Любые выдающиеся асинхронные операции на этот канал завершатся с исключением AsynchronousCloseException. После того, как канал закрывается, дальнейшие попытки инициировать асинхронные операции ввода-вывода, полные сразу с причиной ClosedChannelException.

Этот метод иначе ведет себя точно как определено Channel интерфейс.

Определенный:

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

Определенный:

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

Определенный:

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

Броски:

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