java.nio.channels.spi

Класс AbstractInterruptibleChannel

java.lang. Объект

java.nio.channels.spi.AbstractInterruptibleChannel

Все Реализованные Интерфейсы:

Closeable, AutoCloseable, Канал, InterruptibleChannel

Прямые Известные Подклассы:

FileChannel, SelectableChannel

public abstract class AbstractInterruptibleChannel
extends Object
implements Channel, InterruptibleChannel

Основной класс реализации для прерывистых каналов.

Этот класс инкапсулирует низкоуровневую машину, требуемую реализовывать асинхронное закрытие и прерывание каналов. Конкретный класс канала должен вызвать begin и end методы прежде и после, соответственно, вызывая работу ввода-вывода, которая могла бы блокировать неопределенно. Чтобы гарантировать что end метод всегда вызывается, эти методы должны использоваться в пределах try ... блок finally:

 boolean completed = false;
 try {
     begin();
     completed = ...;    // Perform blocking I/O operation
     return ...;         // Return result
 } finally {
     end(completed);
 }

Параметр completed end метод говорит, имело ли работа ввода-вывода, фактически завершенная, то есть, ли это любой эффект, который будет видим к invoker. В случае работы, которая читает байты, например, этим параметром должен быть true, если, и только если, некоторые байты были фактически переданы в целевой буфер invoker.

Конкретный класс канала должен также реализовать implCloseChannel метод таким способом, который, если это вызывается, в то время как другой поток блокируется в собственной работе ввода-вывода на канал тогда, что работа сразу возвратится, или выдавая исключение или возвращаясь обычно. Если поток прерывается или канал, на который он блокируется, асинхронно закрывается тогда канал end метод выдаст соответствующее исключение.

Этот класс выполняет синхронизацию, требуемую реализовывать Channel спецификация. Реализации implCloseChannel метод не должен синхронизироваться против других потоков, которые могли бы пытаться закрыть канал.

С тех пор:

1.4

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	AbstractInterruptibleChannel() Инициализирует новый экземпляр этого класса.

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

Методы

Модификатор и Тип	Метод и Описание
protected void	begin() Отмечает начало работы ввода-вывода, которая могла бы блокировать неопределенно.
void	close() Завершения этот канал.
protected void	end(boolean completed) Отмечает конец работы ввода-вывода, которая могла бы блокировать неопределенно.
protected abstract void	implCloseChannel() Завершения этот канал.
boolean	isOpen() Говорит, открыт ли этот канал.

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

AbstractInterruptibleChannel

protected AbstractInterruptibleChannel()

Инициализирует новый экземпляр этого класса.

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

близко

public final void close()
                 throws IOException

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

Если канал был уже закрыт тогда, этот метод сразу возвращается. Иначе это отмечает канал как закрыто и затем вызывает implCloseChannel метод, чтобы завершить операцию закрытия.

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

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

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

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

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

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

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

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

Броски:

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

implCloseChannel

protected abstract void implCloseChannel()
                                  throws IOException

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

Этот метод вызывается close метод, чтобы выполнить фактическую работу закрытия канала. Этот метод только вызывается, если канал еще не был закрыт, и это никогда не вызывается не раз.

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

Броски:

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

isOpen

public final boolean isOpen()

Описание скопировало с интерфейса: Channel

Говорит, открыт ли этот канал.

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

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

Возвраты:

true, если, и только если, этот канал открыт

начать

protected final void begin()

Отмечает начало работы ввода-вывода, которая могла бы блокировать неопределенно.

Этот метод должен быть вызван в тандеме с end метод, используя try ... блок finally как показано выше, чтобы реализовать асинхронное закрытие и прерывание для этого канала.

конец

protected final void end(boolean completed)
                  throws AsynchronousCloseException

Отмечает конец работы ввода-вывода, которая могла бы блокировать неопределенно.

Этот метод должен быть вызван в тандеме с begin метод, используя try ... блок finally как показано выше, чтобы реализовать асинхронное закрытие и прерывание для этого канала.

Параметры:

completed - true, если, и только если, работа ввода-вывода, завершенная успешно, то есть, имела некоторый эффект, который будет видим к invoker работы

Броски:

AsynchronousCloseException - Если канал был асинхронно закрыт

ClosedByInterruptException - Если поток, блокированный в работе ввода-вывода, был прерван