java.nio.channels
public interface
public interface
java.nio.channels.Channel
| java.nio.channels.Channel | Closeable |
A channel is a conduit to IO services covering such items as files, sockets, hardware devices, IO ports, or some software component.
Channels are open upon creation, and can be explicitly closed. Once a channel
is closed it cannot be re-opened, and attempts to perform IO operations on
the closed channel result in a ClosedChannelException
.
Particular implementations or sub-interfaces of Channel dictate whether they are thread-safe or not.
Known Indirect Subclasses
AbstractInterruptibleChannel,
AbstractSelectableChannel,
ByteChannel,
DatagramChannel,
FileChannel,
GatheringByteChannel,
InterruptibleChannel,
Pipe.SinkChannel,
Pipe.SourceChannel,
ReadableByteChannel,
ScatteringByteChannel,
SelectableChannel,
ServerSocketChannel,
SocketChannel,
WritableByteChannel
Summary
Public Methods
| void | close() | ||||
| Closes an open channel. | |||||
| boolean | isOpen() | ||||
| Answers whether this channel is open or not. | |||||
Methods inherited
from interface
java.io.Closeable
Details
Public Methods
public void close()
Closes an open channel.
If the channel is already closed this method has no effect. If there is a
problem with closing the channel then the method throws an IOException
and the exception contains reasons for the failure.
If an attempt is made to perform an operation on a closed channel then a
ClosedChannelException will be thrown on that attempt.
If multiple threads attempts to simultaneously close a channel, then only one thread will run the closure code, and others will be blocked until the first returns.
Throws
| IOException | if a problem occurs closing the channel. |
|---|
public boolean isOpen()
Answers whether this channel is open or not.
Returns
- true if the channel is open, otherwise answers false.