InterruptibleChannel

AI-generated Key Takeaways

• InterruptibleChannel allows asynchronous closing and interruption of I/O operations.

• If a thread is blocked on an InterruptibleChannel, closing the channel will throw AsynchronousCloseException to the blocked thread.

• Interrupting a thread blocked on an InterruptibleChannel will close the channel and throw a ClosedByInterruptException.

• The close() method on an InterruptibleChannel behaves like the Channel interface's close() but throws AsynchronousCloseException to blocked threads.

public interface InterruptibleChannel implements Channel

Known Indirect Subclasses AbstractInterruptibleChannel, AbstractSelectableChannel, DatagramChannel, FileChannel, Pipe.SinkChannel, Pipe.SourceChannel, SelectableChannel, ServerSocketChannel, SocketChannel AbstractInterruptibleChannel Base implementation class for interruptible channels.  AbstractSelectableChannel Base implementation class for selectable channels.  DatagramChannel A selectable channel for datagram-oriented sockets.  FileChannel A channel for reading, writing, mapping, and manipulating a file.  Pipe.SinkChannel A channel representing the writable end of a Pipe.  Pipe.SourceChannel A channel representing the readable end of a Pipe.  SelectableChannel A channel that can be multiplexed via a Selector.  ServerSocketChannel A selectable channel for stream-oriented listening sockets.  SocketChannel A selectable channel for stream-oriented connecting sockets.

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.

Public Method Summary

abstract void

close() Closes this channel.

Inherited Method Summary

From interface java.nio.channels.Channel

abstract void	close() Closes this channel.
abstract boolean	isOpen() Tells whether or not this channel is open.

From interface java.io.Closeable

abstract void

close() Closes this stream and releases any system resources associated with it.

From interface java.lang.AutoCloseable

abstract void

close() Closes this resource, relinquishing any underlying resources.

Public Methods

public abstract void 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.

Throws

IOException	If an I/O error occurs