模块  java.base
软件包  java.nio.channels

Class ServerSocketChannel

  • 实现的所有接口
    Closeable ， AutoCloseable ， Channel ， InterruptibleChannel ， NetworkChannel 
    public abstract class ServerSocketChannelextends AbstractSelectableChannelimplements NetworkChannel
    面向流的侦听套接字的可选通道。

    通过调用此类的open方法创建服务器套接字通道。 无法为任意预先存在的ServerSocket创建通道。 新创建的服务器套接字通道已打开但尚未绑定。 尝试调用未绑定的服务器套接字通道的accept方法将导致抛出NotYetBoundException 。 可以通过调用此类定义的bind方法之一来绑定服务器套接字通道。

    使用setOption方法配置套接字选项。 服务器套接字通道支持以下选项：

    Socket options
    Option Name 描述
    SO_RCVBUF The size of the socket receive buffer
    SO_REUSEADDR Re-use address
    还可以支持其他（特定于实现的）选项。

    服务器套接字通道可安全地由多个并发线程使用。

    从以下版本开始：
    1.4

    • 构造方法详细信息

      • ServerSocketChannel

        protected ServerSocketChannel​(SelectorProvider provider)
        初始化此类的新实例。
        参数
        provider - 创建此频道的提供商

    • 方法详细信息

      • open

        public static ServerSocketChannel open()                                throws IOException
        打开服务器套接字通道。

        通过调用系统范围的默认SelectorProvider对象的openServerSocketChannel方法来创建新通道。

        新频道的套接字最初是未绑定的; 它必须通过其套接字bind方法之一绑定到特定地址才能接受连接。

        结果
        一个新的套接字通道
        异常
        IOException - 如果发生I / O错误

      • validOps

        public final int validOps()
        返回标识此通道支持的操作的操作集。

        服务器套接字通道仅支持接受新连接，因此此方法返回SelectionKey.OP_ACCEPT 。

        Specified by:
        validOps在类 SelectableChannel
        结果
        有效操作集

      • bind

        public abstract ServerSocketChannel bind​(SocketAddress local,                                         int backlog)                                  throws IOException
        将通道的套接字绑定到本地地址并配置套接字以侦听连接。

        此方法用于在套接字和本地地址之间建立关联。 一旦建立关联，则套接字保持绑定直到通道关闭。

        backlog参数是套接字上的最大挂起连接数。 它的确切语义是特定于实现的。 特别地，实现可以施加最大长度或者可以选择忽略参数altogther。 如果backlog参数的值为0或负值，则使用特定于实现的默认值。

        参数
        local - 绑定套接字的地址，或 null绑定到自动分配的套接字地址
        backlog - 最大挂起连接数
        结果
        这个频道
        异常
        AlreadyBoundException - 如果套接字已绑定
        UnsupportedAddressTypeException - 如果不支持给定地址的类型
        ClosedChannelException - 如果此频道已关闭
        IOException - 如果发生其他一些I / O错误
        SecurityException - 如果已安装安全管理器且其 checkListen方法拒绝操作
        从以下版本开始：
        1.7

      • socket

        public abstract ServerSocket socket()
        检索与此通道关联的服务器套接字。

        返回的对象不会声明未在ServerSocket类中声明的任何公共方法。

        结果
        与此通道关联的服务器套接字

      • accept

        public abstract SocketChannel accept()                              throws IOException
        接受与此通道套接字的连接。

        如果此通道处于非阻塞模式，则如果没有挂起连接，则此方法将立即返回null 。 否则它将无限期地阻塞，直到新连接可用或发生I / O错误。

        无论此通道的阻塞模式如何，此方法返回的套接字通道（如果有）都将处于阻塞模式。

        此方法执行与ServerSocket类的accept方法完全相同的安全检查。 也就是说，如果已安装安全管理器，则对于每个新连接，此方法将验证安全管理器checkAccept方法是否允许连接的远程端点的地址和端口号。

        结果
        新连接的套接字通道，如果此通道处于非阻塞模式且没有可接受的连接， null
        异常
        ClosedChannelException - 如果此频道已关闭
        AsynchronousCloseException - 如果另一个线程在接受操作正在进行时关闭此通道
        ClosedByInterruptException - 如果另一个线程在接受操作正在进行时中断当前线程，从而关闭通道并设置当前线程的中断状态
        NotYetBoundException - 如果此通道的套接字尚未绑定
        SecurityException - 如果已安装安全管理器且不允许访问新连接的远程端点
        IOException - 如果发生其他一些I / O错误

      • getLocalAddress

        public abstract SocketAddress getLocalAddress()                                       throws IOException
        返回此通道的套接字绑定的套接字地址。

        如果通道是bound到Internet协议套接字地址，则此方法的返回值是InetSocketAddress类型。

        如果存在安全管理器集，则使用本地地址和-1作为其参数调用其checkConnect方法，以查看是否允许该操作。 如果不允许该操作，则SocketAddress表示loopback地址的SocketAddress和通道套接字的本地端口。

        Specified by:
        getLocalAddress在界面 NetworkChannel
        结果
        该 SocketAddress这套接字绑定到，或 SocketAddress代表的环回地址，如果安全管理器拒绝，或 null如果通道的套接字不绑定
        异常
        ClosedChannelException - 如果频道已关闭
        IOException - 如果发生I / O错误