compact1, compact2, compact3

java.nio.channels

Interface NetworkChannel

All Superinterfaces:

AutoCloseable ， Channel ， Closeable

All Known Subinterfaces:

MulticastChannel

所有已知实现类：

AsynchronousServerSocketChannel ， AsynchronousSocketChannel ， DatagramChannel ， ServerSocketChannel ， SocketChannel

public interface NetworkChannel
extends Channel

到网络插座的通道。

实现此接口的通道是通向网络套接字的通道。 该bind方法用于套接字绑定到本地address ，所述getLocalAddress方法返回套接字绑定到地址， setOption种getOption方法用于设置和查询套接字选项。 此接口的实现应指定其支持的套接字选项。

指定不另外具有值返回值的bind和setOption方法来返回调用它们的网络通道。 这允许方法调用被链接。 该接口的实现应该专门化返回类型，以便可以链接实现类上的方法调用。

从以下版本开始：

1.7

方法摘要

Modifier and Type	Method and Description
NetworkChannel	bind(SocketAddress local) 将通道的套接字绑定到本地地址。
SocketAddress	getLocalAddress() 返回此通道的套接字所绑定的套接字地址。
<T> T	getOption(SocketOption<T> name) 返回套接字选项的值。
<T> NetworkChannel	setOption(SocketOption<T> name, T value) 设置套接字选项的值。
Set<SocketOption<?>>	supportedOptions() 返回此通道支持的一组套接字选项。

Methods inherited from interface java.nio.channels.Channel

close, isOpen

方法详细信息

bind

NetworkChannel bind(SocketAddress local)
             throws IOException

将通道的套接字绑定到本地地址。

该方法用于在套接字和本地地址之间建立关联。 一旦建立关联，则套接字保持绑定，直到通道关闭。 如果local参数的值为null则套接字将被绑定到自动分配的地址。

参数

local - 绑定套接字的地址，或 null将套接字绑定到自动分配的套接字地址

结果

这个频道

异常

AlreadyBoundException - 如果套接字已经绑定

UnsupportedAddressTypeException - 如果不支持给定地址的类型

ClosedChannelException - 如果通道关闭

IOException - 如果发生其他I / O错误

SecurityException - 如果安装了一个安全管理器，并且它拒绝了未指定的权限。 此接口的实现应指定任何所需的权限。

另请参见：

getLocalAddress()

getLocalAddress

SocketAddress getLocalAddress()
                       throws IOException

返回此通道的套接字所绑定的套接字地址。

通道为Internet协议套接字地址的bound ，则此方法的返回值为InetSocketAddress 。

结果

套接字绑定的套接字地址，如果通道的套接字未绑定， null

异常

ClosedChannelException - 如果通道关闭

IOException - 如果发生I / O错误

setOption

<T> NetworkChannel setOption(SocketOption<T> name,
                             T value)
                      throws IOException

设置套接字选项的值。

参数类型

T - 套接字选项值的类型

参数

name - 套接字选项

value - 套接字选项的值。 值为null可能是某些套接字选项的有效值。

结果

这个频道

异常

UnsupportedOperationException - 如果此通道不支持套接字选项

IllegalArgumentException - 如果该值不是此套接字选项的有效值

ClosedChannelException - 如果此通道关闭

IOException - 如果发生I / O错误

另请参见：

StandardSocketOptions

getOption

<T> T getOption(SocketOption<T> name)
         throws IOException

返回套接字选项的值。

参数类型

T - 套接字选项值的类型

参数

name - 套接字选项

结果

套接字选项的值。 值为null可能是某些套接字选项的有效值。

异常

UnsupportedOperationException - 如果此通道不支持套接字选项

ClosedChannelException - 如果此通道关闭

IOException - 如果发生I / O错误

另请参见：

StandardSocketOptions

supportedOptions

Set<SocketOption<?>> supportedOptions()

返回此通道支持的一组套接字选项。

即使通道关闭后，此方法仍将继续返回该选项。

结果

A set of the socket options supported by this channel