-
- 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()
返回此通道支持的一组套接字选项。
-
-
-
方法详细信息
-
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
-
-