Module java.base

Package java.nio.channels

Interface NetworkChannel

所有超级接口:

AutoCloseable, Channel, Closeable

所有已知子接口:

MulticastChannel

所有已知实现类:

AsynchronousServerSocketChannel, AsynchronousSocketChannel, DatagramChannel, ServerSocketChannel, SocketChannel

       public interface NetworkChannel extends Channel
      

一个到网络套接字的通道。

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

没有其他返回值的bind和setOption方法被指定为返回调用它们的网络通道。这允许方法调用被链接。此接口的实现应专门化返回类型，以便可以链接对实现类的方法调用。

自版本:

1.7

Method Summary

Modifier and Type	Method	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 declared in interface java.nio.channels.Channel

close, isOpen

Method Details

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到互联网协议套接字地址，则此方法的返回值类型为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()
            

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

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

返回:

此通道支持的套接字选项集