AutoCloseable
, Channel
, Closeable
AbstractInterruptibleChannel
, AbstractSelectableChannel
, DatagramChannel
, FileChannel
, Pipe.SinkChannel
, Pipe.SourceChannel
, SelectableChannel
, ServerSocketChannel
, SocketChannel
public interface InterruptibleChannel extends Channel
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.
Modifier and Type | Method | Description |
---|---|---|
void |
close() |
Closes this channel.
|
void close() throws IOException
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.
close
in interface AutoCloseable
close
in interface Channel
close
in interface Closeable
IOException
- If an I/O error occurs Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2017, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.
DRAFT 9-internal+0-adhoc.mlchung.jdk9-jdeps