模块 java.base

软件包 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

方法摘要

变量和类型	方法	描述
NetworkChannel	bind(SocketAddress local)	将通道的套接字绑定到本地地址。
SocketAddress	getLocalAddress()	返回此通道的套接字绑定的套接字地址。
<T> T	getOption(SocketOption<T> name)	返回套接字选项的值。
<T> NetworkChannel	setOption(SocketOption<T> name, T value)	设置套接字选项的值。
Set<SocketOption<?>>	supportedOptions()	返回此通道支持的一组套接字选项。

声明方法的接口 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

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

如果通道是bound到Internet协议套接字地址，则此方法的返回值是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