Top Description Methods
java.nio.channels

public Interface InterruptibleChannel

extends Channel
Known Direct Implementers
java.nio.channels.spi.AbstractInterruptibleChannel
Imports
java.io.IOException

A channel that can be asynchronously closed and interrupted.

A channel that implements this interface is asynchronously closeable: If a thread is blocked in an I/O operation on an interruptible channel then another thread may invoke the channel's close method. This will cause the blocked thread to receive an AsynchronousCloseException.

A channel that implements this interface is also interruptible: If a thread is blocked in an I/O operation on an interruptible channel then another thread may invoke the blocked thread's interrupt method. This will cause the channel to be closed, the blocked thread to receive a ClosedByInterruptException, and the blocked thread's interrupt status to be set.

If a thread's interrupt status is already set and it invokes a blocking I/O operation upon a channel then the channel will be closed and the thread will immediately receive a ClosedByInterruptException; its interrupt status will remain set.

A channel supports asynchronous closing and interruption if, and only if, it implements this interface. This can be tested at runtime, if necessary, via the instanceof operator.

Authors
Mark Reinhold, JSR-51 Expert Group
Since
1.4

Method Summary

Modifier and TypeMethod and Description
public void
close()

Redeclares java.nio.channels.Channel.close.

Closes this channel.

Inherited from java.nio.channels.Channel:
isOpen

Method Detail

closeback to summary
public void close() throws IOException

Redeclares java.nio.channels.Channel.close.

Closes this channel.

Any thread currently blocked in an I/O operation upon this channel will receive an AsynchronousCloseException.

This method otherwise behaves exactly as specified by the Channel interface.

Exceptions
IOException:
If an I/O error occurs