InterruptibleChannel
Stay organized with collections
Save and categorize content based on your preferences.
Known Indirect Subclasses
|
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.io.Closeable
abstract
void
|
close()
Closes this stream and releases any system resources associated
with it.
|
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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-10 UTC."],[[["`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."]]],["The `InterruptibleChannel` interface allows for asynchronous closing and interruption of channels. If a thread is blocked in an I/O operation on such a channel, another thread can close it, causing an `AsynchronousCloseException`, or interrupt the blocked thread, resulting in a `ClosedByInterruptException`. This interface also enables checking for these behaviors via the `instanceof` operator. The primary action is the `close()` method, which closes the channel and may throw an `AsynchronousCloseException` to a blocked thread.\n"]]