ServerSocket (Java Platform SE 8 )

java.lang.Object
- java.net.ServerSocket

All Implemented Interfaces:

Closeable ， AutoCloseable

已知直接子类：

SSLServerSocket
```
public class ServerSocket
extends Object
implements Closeable
```
这个类实现了服务器套接字。服务器套接字等待通过网络进入的请求。它根据该请求执行一些操作，然后可能将结果返回给请求者。
服务器套接字的实际工作由SocketImpl类的实例执行。应用程序可以更改创建套接字实现的套接字工厂，以配置自己创建适合本地防火墙的套接字。

从以下版本开始：

JDK1.0

另请参见：

SocketImpl ， setSocketFactory(java.net.SocketImplFactory) ， ServerSocketChannel

构造方法摘要

构造方法
Constructor and Description
`ServerSocket()` 创建未绑定的服务器套接字。
`ServerSocket(int port)` 创建绑定到指定端口的服务器套接字。
`ServerSocket(int port, int backlog)` 创建服务器套接字并将其绑定到指定的本地端口号，并指定了积压。
`ServerSocket(int port, int backlog, InetAddress bindAddr)` 创建一个具有指定端口的服务器，侦听backlog和本地IP地址绑定。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`Socket`	`accept()` 侦听要连接到此套接字并接受它。
`void`	`bind(SocketAddress endpoint)` 将 `ServerSocket`绑定到特定地址（IP地址和端口号）。
`void`	`bind(SocketAddress endpoint, int backlog)` 将 `ServerSocket`绑定到特定地址（IP地址和端口号）。
`void`	`close()` 关闭此套接字。
`ServerSocketChannel`	`getChannel()` 返回与此套接字相关联的唯一的`ServerSocketChannel`对象（如果有）。
`InetAddress`	`getInetAddress()` 返回此服务器套接字的本地地址。
`int`	`getLocalPort()` 返回此套接字正在侦听的端口号。
`SocketAddress`	`getLocalSocketAddress()` 返回此套接字绑定到的端点的地址。
`int`	`getReceiveBufferSize()` 获取此 `ServerSocket`的 `SO_RCVBUF`选项的值，即将用于从该 `ServerSocket`接受的套接字的建议缓冲区大小。
`boolean`	`getReuseAddress()` 测试是否启用了 `SO_REUSEADDR` 。
`int`	`getSoTimeout()` 检索 `SO_TIMEOUT`的设置。
`protected void`	`implAccept(Socket s)` ServerSocket的子类使用这个方法来覆盖accept（）来返回自己的套接字子类。
`boolean`	`isBound()` 返回ServerSocket的绑定状态。
`boolean`	`isClosed()` 返回ServerSocket的关闭状态。
`void`	`setPerformancePreferences(int connectionTime, int latency, int bandwidth)` 设置此ServerSocket的性能首选项。
`void`	`setReceiveBufferSize(int size)` 设置从 `ServerSocket`接受的套接字的 `SO_RCVBUF`选项的默认建议值。
`void`	`setReuseAddress(boolean on)` 启用/禁用 `SO_REUSEADDR`套接字选项。
`static void`	`setSocketFactory(SocketImplFactory fac)` 设置应用程序的服务器套接字实现工厂。
`void`	`setSoTimeout(int timeout)` 启用/禁用 `SO_TIMEOUT`带有指定超时，以毫秒为单位。
`String`	`toString()` 将该套接字的实现地址和实现端口返回为 `String` 。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造方法详细信息
  - ServerSocket
```
public ServerSocket()
             throws IOException
```
    创建未绑定的服务器套接字。
    
    异常
    
    IOException - 打开插槽时的IO错误。
  - ServerSocket
```
public ServerSocket(int port)
             throws IOException
```
    创建绑定到指定端口的服务器套接字。端口号0表示端口号是自动分配的，通常是从短暂的端口范围。这个端口号可以通过调用getLocalPort来检索。
    输入连接指示（连接请求）的最大队列长度设置为50 。如果连接指示在队列已满时到达，则连接被拒绝。
    
    如果应用程序指定了服务器套接字工厂，则调用该工厂的createSocketImpl方法来创建实际的套接字实现。否则，将创建一个“普通”套接字。
    
    如果有安全管理器， checkListen方法被称为与port作为其参数，以确保允许该操作。这可能会导致SecurityException。
    
    参数
    
    port - 端口号，或 0使用 0分配的端口号。
    
    异常
    
    IOException - 打开插槽时是否发生I / O错误。
    
    SecurityException - 如果安全管理器存在，并且其 checkListen方法不允许操作。
    
    IllegalArgumentException - 如果端口参数超出了指定的有效端口值范围（介于0和65535之间），包括0和65535之间。
    
    另请参见：
    
    SocketImpl ， SocketImplFactory.createSocketImpl() ， setSocketFactory(java.net.SocketImplFactory) ， SecurityManager.checkListen(int)
  - ServerSocket
```
public ServerSocket(int port,
                    int backlog)
             throws IOException
```
    创建服务器套接字并将其绑定到指定的本地端口号，并指定了积压。端口号0表示端口号自动分配，通常是从短暂端口范围。这个端口号可以通过调用getLocalPort来检索。
    输入连接指示（连接请求）的最大队列长度设置为backlog参数。如果连接指示在队列已满时到达，则连接被拒绝。
    
    如果应用程序指定了服务器套接字工厂，则调用该工厂的createSocketImpl方法来创建实际的套接字实现。否则，将创建一个“普通”套接字。
    
    如果有安全管理器， checkListen方法被称为与port作为其参数，以确保允许该操作。这可能会导致SecurityException。 backlog参数是套接字上请求的最大挂起连接数。其确切语义是实现具体的。特别地，实现可以施加最大长度，或者可以选择忽略参数altogther。提供的价值应大于0 。如果它小于或等于0 ，则将使用实现特定的默认值。
    
    参数
    
    port - 端口号，或 0使用 0分配的端口号。
    
    backlog - 请求进入连接队列的最大长度。
    
    异常
    
    IOException - 打开插槽时是否发生I / O错误。
    
    SecurityException - 如果安全管理器存在，并且其 checkListen方法不允许操作。
    
    IllegalArgumentException - 如果端口参数超出了介于0和65535之间的有效端口值的指定范围（包括0和65535之间）。
    
    另请参见：
    
    SocketImpl ， SocketImplFactory.createSocketImpl() ， setSocketFactory(java.net.SocketImplFactory) ， SecurityManager.checkListen(int)
  - ServerSocket
```
public ServerSocket(int port,
                    int backlog,
                    InetAddress bindAddr)
             throws IOException
```
    创建一个具有指定端口的服务器，侦听backlog和本地IP地址绑定。 bindAddr参数可以在多宿主主机上用于ServerSocket，该主机将只接受对其地址之一的连接请求。如果bindAddr为null，它将默认接受任何/所有本地地址上的连接。端口必须在0和65535之间，包括端点。端口号0表示端口号自动分配，通常来自短暂的端口范围。这个端口号可以通过调用getLocalPort来检索。
    如果有安全管理器，此方法调用其checkListen方法与port作为其参数，以确保允许该操作。这可能会导致SecurityException。 backlog参数是套接字上请求的最大挂起连接数。其确切语义是实现具体的。特别地，实现可以施加最大长度，或者可以选择忽略参数altogther。提供的价值应大于0 。如果小于或等于0 ，则将使用实现特定的默认值。
    
    参数
    
    port - 端口号，或 0使用 0分配的端口号。
    
    backlog - 请求进入连接队列的最大长度。
    
    bindAddr - 服务器将绑定到的本地InetAddress
    
    异常
    
    SecurityException - 如果存在安全管理员，并且其 checkListen方法不允许操作。
    
    IOException - 打开插槽时是否发生I / O错误。
    
    IllegalArgumentException - 如果端口参数超出了有效端口值的指定范围（介于0和65535之间），包括0和65535之间。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    SocketOptions ， SocketImpl ， SecurityManager.checkListen(int)
- 方法详细信息
  - bind
```
public void bind(SocketAddress endpoint)
          throws IOException
```
    将ServerSocket绑定到特定地址（IP地址和端口号）。
    如果地址为null ，则系统将接收临时端口和有效的本地地址来绑定套接字。
    
    参数
    
    endpoint - 绑定到的IP地址和端口号。
    
    异常
    
    IOException - 如果绑定操作失败，或者套接字已经绑定。
    
    SecurityException - 如果一个 SecurityManager存在，其 checkListen方法不允许操作。
    
    IllegalArgumentException - 如果端点是此套接字不支持的SocketAddress子类
    
    从以下版本开始：
    
    1.4
  - bind
```
public void bind(SocketAddress endpoint,
                 int backlog)
          throws IOException
```
    将ServerSocket绑定到特定地址（IP地址和端口号）。
    如果地址为null ，则系统将接收临时端口和有效的本地地址来绑定套接字。
    
    backlog参数是套接字上请求的最大挂起连接数。其确切语义是实现具体的。特别地，实现可以施加最大长度，或者可以选择忽略参数altogther。提供的价值应大于0 。如果小于或等于0 ，则将使用实现特定的默认值。
    
    参数
    
    endpoint - 绑定到的IP地址和端口号。
    
    backlog - 请求进入连接队列的最大长度。
    
    异常
    
    IOException - 如果绑定操作失败，或者套接字已经绑定。
    
    SecurityException - 如果存在 SecurityManager ，并且其 checkListen方法不允许操作。
    
    IllegalArgumentException - 如果端点是此套接字不支持的SocketAddress子类
    
    从以下版本开始：
    
    1.4
  - getInetAddress
```
public InetAddress getInetAddress()
```
    返回此服务器套接字的本地地址。
    如果套接字被绑定在closed之前，则该方法将在套接字关闭后继续返回本地地址。
    
    如果有一个安全管理器集，其checkConnect方法checkConnect本地地址和-1作为参数来调用，以查看是否允许该操作。如果不允许操作，则返回loopback地址。
    
    结果
    
    该套接字绑定到的地址，或者如果安全管理器被拒绝的环回地址，如果套接字未绑定， null 。
    
    另请参见：
    
    SecurityManager.checkConnect(java.lang.String, int)
  - getLocalPort
```
public int getLocalPort()
```
    返回此套接字正在侦听的端口号。
    如果套接字被绑定在closed之前，则该方法将在套接字关闭后继续返回端口号。
    
    结果
    
    该套接字正在侦听的端口号，如果套接字尚未绑定，则为-1。
  - getLocalSocketAddress
```
public SocketAddress getLocalSocketAddress()
```
    返回此套接字绑定到的端点的地址。
    如果套接字被绑定在closed之前，则该方法将在套接字关闭后继续返回端点的地址。
    
    如果有一个安全管理器集，其checkConnect方法checkConnect本地地址和-1作为参数来调用，以查看是否允许该操作。如果不允许操作，则SocketAddress表示loopback地址的SocketAddress和套接字所绑定的本地端口。
    
    结果
    
    一个 SocketAddress该套接字的本地端点的 SocketAddress ，或者如果安全管理器拒绝，则表示该环回地址的 null如果套接字尚未绑定， null 。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    getInetAddress() ， getLocalPort() ， bind(SocketAddress) ， SecurityManager.checkConnect(java.lang.String, int)
  - accept
```
public Socket accept()
              throws IOException
```
    侦听要连接到此套接字并接受它。该方法将阻塞直到建立连接。
    创建一个新的Socket s ，如果有安全管理器，则使用s.getInetAddress().getHostAddress()和s.getPort()作为其参数来调用安全管理器的checkAccept方法，以确保允许操作。这可能会导致SecurityException。
    
    结果
    
    新的Socket
    
    异常
    
    IOException - 如果在等待连接时发生I / O错误。
    
    SecurityException - 如果安全管理器存在，并且其 checkAccept方法不允许操作。
    
    SocketTimeoutException - 如果先前使用setSoTimeout设置了超时并且达到超时。
    
    IllegalBlockingModeException - 如果此套接字具有关联的通道，则该通道处于非阻塞模式，并且没有准备接受的连接
    
    另请参见：
    
    SecurityManager.checkAccept(java.lang.String, int)
  - implAccept
```
protected final void implAccept(Socket s)
                         throws IOException
```
    ServerSocket的子类使用这个方法来覆盖accept（）来返回自己的套接字子类。所以一个FooServerSocket通常会把这个方法变成一个空的 FooSocket。从implAccept返回FooSocket将连接到客户端。
    
    参数
    
    s - 套接字
    
    异常
    
    IllegalBlockingModeException - 如果此套接字具有关联的通道，并且通道处于非阻塞模式
    
    IOException - 如果在等待连接时发生I / O错误。
    
    从以下版本开始：
    
    JDK1.1
  - close
```
public void close()
           throws IOException
```
    关闭此套接字。目前受阻于任何线程accept()将抛出一个SocketException 。
    如果此套接字具有关联的通道，则通道也将关闭。
    
    Specified by:
    
    close在接口 Closeable
    
    Specified by:
    
    close中的 AutoCloseable
    
    异常
    
    IOException - 如果关闭套接字时发生I / O错误。
  - getChannel
```
public ServerSocketChannel getChannel()
```
    返回与此套接字相关联的唯一的ServerSocketChannel对象（如果有）。
    如果只有通道本身是通过ServerSocketChannel.open方法创建的，则服务器套接字将具有通道。
    
    结果
    
    与此套接字关联的服务器套接字通道，如果未为通道创建此插槽， null
    
    从以下版本开始：
    
    1.4
  - isBound
```
public boolean isBound()
```
    返回ServerSocket的绑定状态。
    
    结果
    
    如果ServerSocket成功绑定到一个地址，则为true
    
    从以下版本开始：
    
    1.4
  - isClosed
```
public boolean isClosed()
```
    返回ServerSocket的关闭状态。
    
    结果
    
    如果套接字已关闭，则为true
    
    从以下版本开始：
    
    1.4
  - setSoTimeout
```
public void setSoTimeout(int timeout)
                  throws SocketException
```
    启用/禁用SO_TIMEOUT带有指定超时，以毫秒为单位。使用此选项设置为非零超时，对此ServerSocket的accept（）的调用将仅阻止此时间。如果超时超时，则会引发java.net.SocketTimeoutException ，尽管ServerSocket仍然有效。必须先启用该选项才能进入阻止操作才能生效。超时时间必须为> 0 。超时为零被解释为无限超时。
    
    参数
    
    timeout - 指定的超时，以毫秒为单位
    
    异常
    
    SocketException - 如果底层协议有错误，如TCP错误。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    getSoTimeout()
  - getSoTimeout
```
public int getSoTimeout()
                 throws IOException
```
    检索SO_TIMEOUT的设置。 0返回意味着该选项被禁用（即无限超时）。
    
    结果
    
    SO_TIMEOUT的价值
    
    异常
    
    IOException - 如果发生I / O错误
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    setSoTimeout(int)
  - setReuseAddress
```
public void setReuseAddress(boolean on)
                     throws SocketException
```
    启用/禁用SO_REUSEADDR套接字选项。
    当TCP连接关闭时，连接可能会在连接关闭后一段时间内保持在超时状态（通常称为TIME_WAIT状态或2MSL等待状态）。对于使用众所周知的套接字地址或端口的应用SocketAddress如果在涉及套接字地址或端口的超时状态中存在连接，则可能无法将套接字绑定到所需的SocketAddress 。
    
    启用SO_REUSEADDR之前结合使用套接字bind(SocketAddress)允许在上一个连接处于超时状态时绑定套接字。
    
    当ServerSocket被创建的初始设定SO_REUSEADDR没有定义。应用程序可以使用getReuseAddress()来确定初始设置为SO_REUSEADDR 。
    
    套接字绑定后启用或禁用SO_REUSEADDR时的行为（见isBound() ）未定义。
    
    参数
    
    on - 是否启用或禁用套接字选项
    
    异常
    
    SocketException - 如果出现错误，启用或禁用 SO_REUSEADDR套接字选项，或者插座已关闭。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    getReuseAddress() ， bind(SocketAddress) ， isBound() ， isClosed()
  - getReuseAddress
```
public boolean getReuseAddress()
                        throws SocketException
```
    测试是否启用了 SO_REUSEADDR 。
    
    结果
    
    一个 boolean是否启用 SO_REUSEADDR的boolean 。
    
    异常
    
    SocketException - 如果底层协议有错误，例如TCP错误。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    setReuseAddress(boolean)
  - toString
```
public String toString()
```
    将此套接字的实现地址和实现端口作为String 。
    如果有一个安全管理器集，它的checkConnect方法被调用本地地址和-1作为参数来查看是否允许该操作。如果不允许的操作， InetAddress代表loopback个地址返回作为实现地址。
    
    重写：
    
    toString在 Object
    
    结果
    
    这个套接字的字符串表示形式。
  - setSocketFactory
```
public static void setSocketFactory(SocketImplFactory fac)
                             throws IOException
```
    设置应用程序的服务器套接字实现工厂。工厂只能指定一次。
    当应用程序创建新的服务器套接字时，将调用套接字实现工厂的createSocketImpl方法来创建实际的套接字实现。
    
    通过null的方法是一个no-op，除非工厂已经设置。
    
    如果有安全管理员，则该方法首先调用安全管理器的checkSetFactory方法，以确保允许操作。这可能会导致SecurityException。
    
    参数
    
    fac - 所需工厂。
    
    异常
    
    IOException - 设置插座工厂时是否发生I / O错误。
    
    SocketException - 如果工厂已经被定义。
    
    SecurityException - 如果存在安全管理员，并且其 checkSetFactory方法不允许操作。
    
    另请参见：
    
    SocketImplFactory.createSocketImpl() ， SecurityManager.checkSetFactory()
  - setReceiveBufferSize
```
public void setReceiveBufferSize(int size)
                          throws SocketException
```
    设置为默认建议值SO_RCVBUF选项从该接受的套接字ServerSocket 。在接受的套接字中实际设置的值必须通过在accept()返回套接字后调用Socket.getReceiveBufferSize()来确定。
    SO_RCVBUF的值用于设置内部套接字接收缓冲区的大小，并设置通告给远程对等体的TCP接收窗口的大小。
    
    可以通过调用Socket.setReceiveBufferSize(int)来随后更改值。然而，如果应用程序希望允许大于64K字节的接收窗口，如RFC1323定义的那样，则在ServerSocket绑定到本地地址之前必须设置建议值。这意味着必须使用无参数构造函数创建ServerSocket，那么必须调用setReceiveBufferSize（），最后调用bind（）将ServerSocket绑定到一个地址。
    
    否则不会导致错误，并且缓冲区大小可能设置为请求的值，但从该ServerSocket接受的套接字中的TCP接收窗口将不会大于64K字节。
    
    参数
    
    size - 设置接收缓冲区大小的大小。该值必须大于0。
    
    异常
    
    SocketException - 如果底层协议有错误，如TCP错误。
    
    IllegalArgumentException - 如果值为0或为负。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    getReceiveBufferSize()
  - getReceiveBufferSize
```
public int getReceiveBufferSize()
                         throws SocketException
```
    获取的值SO_RCVBUF选项这个ServerSocket ，这是将用于从此接受的套接字的建议缓冲区大小ServerSocket 。
    注意，在接受的套接字中实际设置的值是通过调用Socket.getReceiveBufferSize()确定的。
    
    结果
    
    该 SO_RCVBUF期权的价值为 Socket 。
    
    异常
    
    SocketException - 如果底层协议有错误，如TCP错误。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    setReceiveBufferSize(int)
  - setPerformancePreferences
```
public void setPerformancePreferences(int connectionTime,
                                      int latency,
                                      int bandwidth)
```
    设置此ServerSocket的性能首选项。
    套接字默认使用TCP / IP协议。一些实现可以提供具有与TCP / IP不同的性能特征的替代协议。该方法允许应用程序表达自己的偏好，以便在实现从可用协议中选择时应如何进行这些权衡。
    
    性能偏好由三个整数描述，其值表示短连接时间，低延迟和高带宽的相对重要性。整数的绝对值是无关紧要的; 为了选择协议，简单地比较值，较大的值表示较强的偏好。例如，如果应用程序优先考虑低延迟和高带宽的短连接时间，则可以使用值(1, 0, 0)调用此方法。如果应用程序喜欢低于低延迟的高带宽，并且在短的连接时间以上的低延迟，则可以使用值(0, 1, 2)调用此方法。
    
    在此套接字绑定后调用此方法将不起作用。这意味着为了使用此功能，需要使用无参数构造函数创建套接字。
    
    参数
    
    connectionTime -一个 int表达短连接时间的相对重要性
    
    latency - int低延迟的相对重要性的int
    
    bandwidth -一个 int表达高带宽的相对重要性
    
    从以下版本开始：
    
    1.5

Class ServerSocket

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

ServerSocket

ServerSocket

ServerSocket

ServerSocket

方法详细信息

bind

bind

getInetAddress

getLocalPort

getLocalSocketAddress

accept

implAccept

close

getChannel

isBound

isClosed

setSoTimeout

getSoTimeout

setReuseAddress

getReuseAddress

toString

setSocketFactory

setReceiveBufferSize

getReceiveBufferSize

setPerformancePreferences