FileDocCategorySizeDatePackage
InterruptibleChannel.javaAPI DocAndroid 1.5 API2361Wed May 06 22:41:04 BST 2009java.nio.channels

InterruptibleChannel

public interface InterruptibleChannel implements Channel
Channels that implement this interface can be asynchronously closed and interrupted.

A channel that can be asynchronously closed permits that a thread blocked on an I/O operation (the I/O thread) can be released by another thread calling the channel's {@link #close()} method. The I/O thread will throw an {@link AsynchronousCloseException} and the channel will be closed.

A channel that is interruptible permits a thread blocked on an I/O operation (the I/O thread) to be interrupted by another thread (by invoking {@link Thread#interrupt()} on the I/O thread). When the I/O thread is interrupted it will throw a {@link ClosedByInterruptException}, it will have its interrupted status set and the channel will be closed. If the I/O thread attempts to make an I/O call with the interrupt status set the call will immediately fail with a {@link ClosedByInterruptException}.

since
Android 1.0

Fields Summary
Constructors Summary
Methods Summary
public voidclose()
Closes the channel.

Any threads that are blocked on I/O operations on this channel will be interrupted with an {@link AsynchronousCloseException}. Otherwise, this method behaves the same as defined in the {@code Channel} interface.

throws
IOException if an I/O error occurs while closing the channel.
since
Android 1.0