| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface InterruptibleChannel extends Channel
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 {@link #close close} method. This will cause the blocked thread to receive an {@link 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 {@link Thread#interrupt() interrupt} method. This will cause the channel to be closed, the blocked thread to receive a {@link 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 {@link 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.
Method Summary | |
---|---|
void |
close() Closes this channel. |
Methods inherited from class java.nio.channels.Channel |
---|
close, isOpen |
Methods inherited from class java.io.Closeable |
---|
close |
Method Detail |
---|
public void close() throws IOException
Any thread currently blocked in an I/O operation upon this channel will receive an {@link AsynchronousCloseException}.
This method otherwise behaves exactly as specified by the {@link Channel#close Channel} interface.
IOException
- If an I/O error occurs
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |