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)` 用指定的端口创建一个服务器，听积压，和本地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（）返回自己的子类的插座。
`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

- Constructor Detail
  - ServerSocket
```
public ServerSocket()
             throws IOException
```
    创建一个绑定服务器套接字。
    
    异常
    
    IOException - IO错误当打开套接字。
  - ServerSocket
```
public ServerSocket(int port)
             throws IOException
```
    创建一个服务器套接字，绑定到指定的端口。对 0意味着端口号会自动分配一个端口号，通常是从一个临时端口范围。那么这个端口号可以通过调用 getLocalPort检索。
    传入的连接标志的最大队列长度（连接请求）是集50。如果一个连接指示到达队列已满时，连接被拒绝。
    
    如果应用程序已指定服务器套接字工厂，那个工厂的createSocketImpl方法来创建实际的套接字实现。否则创建一个“普通”套接字。
    
    如果存在安全管理器，它的checkListen方法称为确保操作的参数是允许的port论点。这可能导致SecurityException。
    
    参数
    
    port -端口号，或 0使用端口号是自动分配。
    
    异常
    
    IOException如果I/O错误当打开套接字时发生。
    
    SecurityException -如果存在一个安全管理及其 checkListen方法不允许操作。
    
    IllegalArgumentException如果端口外部端口的值指定的范围内，这是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参数是请求的最大数量的挂起连接在插座上。它的确切的语义是实现特定的。特别是，一个实现可以处以最大长度或可以选择忽略参数的根。所提供的值应大于0。如果是小于或等于0，然后具体实现将使用默认。
    
    参数
    
    port -端口号，或 0使用端口号是自动分配。
    
    backlog请求的最大长度的传入连接队列。
    
    异常
    
    IOException如果I/O错误当打开套接字时发生。
    
    SecurityException -如果存在一个安全管理及其 checkListen方法不允许操作。
    
    IllegalArgumentException如果端口外部端口的值指定的范围内，这是0和65535之间，包容。
    
    另请参见：
    
    SocketImpl， SocketImplFactory.createSocketImpl()， setSocketFactory(java.net.SocketImplFactory)， SecurityManager.checkListen(int)
  - ServerSocket
```
public ServerSocket(int port,
                    int backlog,
                    InetAddress bindAddr)
             throws IOException
```
    用指定的端口创建一个服务器，听积压，和本地IP地址绑定到。的bindaddr参数可用于在多宿主一个ServerSocket，只接受连接请求的一个地址的主机。如果bindaddr是空的，它会默认接受任何/所有本地地址连接。端口必须在65535和0之间，包括。对 0意味着端口号会自动分配一个端口号，通常是从一个临时端口范围。那么这个端口号可以通过调用 getLocalPort检索。
    如果存在安全管理器，这种方法称为确保操作的参数是允许的port论证其checkListen方法。这可能导致SecurityException。的backlog参数是请求的最大数量的挂起连接在插座上。它的确切的语义是实现特定的。特别是，一个实现可以处以最大长度或可以选择忽略参数的根。所提供的值应大于0。如果是小于或等于0，然后具体实现将使用默认。
    
    参数
    
    port -端口号，或 0使用端口号是自动分配。
    
    backlog请求的最大长度的传入连接队列。
    
    bindAddr -本地服务器将绑定到它
    
    异常
    
    SecurityException -如果存在一个安全管理及其 checkListen方法不允许操作。
    
    IOException如果I/O错误当打开套接字时发生。
    
    IllegalArgumentException如果端口外部端口的值指定的范围内，这是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类
    
    从以下版本开始：
    
    一点四
  - bind
```
public void bind(SocketAddress endpoint,
                 int backlog)
          throws IOException
```
    ServerSocket绑定到一个特定的地址（IP地址和端口号）。
    如果地址是null，然后系统会拿起一个临时端口和一个有效的本地地址绑定套接字。
    
    的backlog参数是请求的最大数量的挂起连接在插座上。它的确切的语义是实现特定的。特别是，一个实现可以处以最大长度或可以选择忽略参数的根。所提供的值应大于0。如果是小于或等于0，然后具体实现将使用默认。
    
    参数
    
    endpoint - IP地址和端口号绑定到。
    
    backlog请求的最大长度的传入连接队列。
    
    异常
    
    IOException如果绑定操作失败，或者如果插座已绑定。
    
    SecurityException -如果 SecurityManager存在及其 checkListen方法不允许操作。
    
    IllegalArgumentException如果终点是由这个插座不支持SocketAddress类
    
    从以下版本开始：
    
    一点四
  - getInetAddress
```
public InetAddress getInetAddress()
```
    返回此服务器套接字的本地地址。
    如果插座会被closed之前，那么这个方法之后会继续关闭套接字返回本地地址。
    
    如果存在安全管理器，它的checkConnect方法被调用的本地地址和-1作为它的参数看看操作是允许的。如果操作是不允许的，loopback返回的地址。
    
    结果
    
    地址此套接字绑定，或环回地址如果由安全经理否认，或 null如果套接字绑定。
    
    另请参见：
    
    SecurityManager.checkConnect(java.lang.String, int)
  - getLocalPort
```
public int getLocalPort()
```
    返回此套接字正在侦听的端口号。
    如果插座会被closed之前，本方法将继续在套接字关闭返回的端口号。
    
    结果
    
    套接字正在监听或- 1的端口号，如果套接字还没有绑定。
  - getLocalSocketAddress
```
public SocketAddress getLocalSocketAddress()
```
    返回此套接字绑定到的端点的地址。
    如果插座会被closed之前，本方法将继续在套接字关闭返回的端点地址。
    
    如果存在安全管理器，它的checkConnect方法被调用的本地地址和-1作为它的参数看看操作是允许的。如果操作是不允许的，一个SocketAddress代表loopback地址和本地端口，socket返回。
    
    结果
    
    一个 SocketAddress表示此套接字的本地端点，或 SocketAddress代表回送地址如果由安全经理否认，或 null如果插座不绑定但。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    getInetAddress()， getLocalPort()， bind(SocketAddress)， SecurityManager.checkConnect(java.lang.String, int)
  - accept
```
public Socket accept()
              throws IOException
```
    监听要对这个套接字作出的连接并接受它。该方法块，直到连接。
    一个新的套接字s创造，如果有一个安全经理，安全经理的checkAccept方法被称为s.getInetAddress().getHostAddress()和s.getPort()作为它的参数来保证操作是允许的。这可能导致SecurityException。
    
    结果
    
    新的插座
    
    异常
    
    IOException如果I/O等待连接时发生错误。
    
    SecurityException -如果存在一个安全管理及其 checkAccept方法不允许操作。
    
    SocketTimeoutException如果超时之前设置setsotimeout和超时已达到。
    
    IllegalBlockingModeException -如果这插座都有一个相关的信道，信道是非阻塞模式，并且没有连接好的被接受
    
    另请参见：
    
    SecurityManager.checkAccept(java.lang.String, int)
  - implAccept
```
protected final void implAccept(Socket s)
                         throws IOException
```
    子类使用此方法重载ServerSocket（）返回自己的子类的插座。所以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如果这个插座不是一个通道
    
    从以下版本开始：
    
    一点四
  - isBound
```
public boolean isBound()
```
    返回的ServerSocket绑定状态。
    
    结果
    
    如果ServerSocket成功绑定到一个地址
    
    从以下版本开始：
    
    一点四
  - isClosed
```
public boolean isClosed()
```
    返回的ServerSocket关闭状态。
    
    结果
    
    如果套接字已关闭，则是
    
    从以下版本开始：
    
    一点四
  - setSoTimeout
```
public void setSoTimeout(int timeout)
                  throws SocketException
```
    启用/禁用 SO_TIMEOUT以指定的超时时间，以毫秒为单位。这个选项设置为非零超时，一个叫（）这个ServerSocket将只有这个时间块。如果超时时间已到，一 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如果有连接超时状态涉及socket地址或端口的应用。
    
    使SO_REUSEADDR结合使用bind(SocketAddress)插座允许将套接字绑定即使以前的连接在超时之前的状态。
    
    当一个ServerSocket建立SO_REUSEADDR初始设置不明确。应用程序可以使用getReuseAddress()确定SO_REUSEADDR初始设置。
    
    行为时，SO_REUSEADDR启用或禁用后一个套接字绑定（见isBound()）没有定义。
    
    参数
    
    on -是否启用或禁用套接字选项
    
    异常
    
    SocketException -如果出现错误启用或禁用的 SO_REUSEADDR套接字选项，或关闭套接字。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    getReuseAddress()， bind(SocketAddress)， isBound()， isClosed()
  - getReuseAddress
```
public boolean getReuseAddress()
                        throws SocketException
```
    如果 SO_REUSEADDR启用。
    
    结果
    
    一个 boolean指示是否启用 SO_REUSEADDR。
    
    异常
    
    SocketException -如果在底层协议有错误，例如TCP错误。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    setReuseAddress(boolean)
  - toString
```
public String toString()
```
    返回此套接字作为 String实现的地址与端口。
    如果存在安全管理器，它的checkConnect方法被调用的本地地址和-1作为它的参数看看操作是允许的。如果操作是不允许的，代表loopback地址InetAddress是作为实现返回的地址。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    这个套接字的字符串表示。
  - setSocketFactory
```
public static void setSocketFactory(SocketImplFactory fac)
                             throws IOException
```
    设置服务器套接字实现工厂为应用程序。工厂只能指定一次。
    当一个应用程序创建一个新的服务器套接字，该套接字实现工厂的createSocketImpl方法来创建实际的套接字实现。
    
    通过null的方法是一种无OP除非厂家已经设置。
    
    如果存在安全管理器，该方法首先调用安全管理器的checkSetFactory方法确保操作是允许的。这可能导致SecurityException。
    
    参数
    
    fac -所需的工厂。
    
    异常
    
    IOException -如果一个I / O错误设置套接字工厂时。
    
    SocketException -如果工厂已被定义。
    
    SecurityException -如果存在一个安全管理及其 checkSetFactory方法不允许操作。
    
    另请参见：
    
    SocketImplFactory.createSocketImpl()， SecurityManager.checkSetFactory()
  - setReceiveBufferSize
```
public void setReceiveBufferSize(int size)
                          throws SocketException
```
    设置一个默认值为提出接受这 ServerSocket插座 SO_RCVBUF选项。其实在接受套接字的价值必须通过在socket返回调用 Socket.getReceiveBufferSize()确定 accept()。
    对SO_RCVBUF值是用来设置内部套接字接收缓冲区的大小，并设置TCP接收窗口的大小，这样的远程对等。
    
    这是有可能改变的值，随后，通过调用Socket.setReceiveBufferSize(int)。然而，如果应用程序希望允许接收窗口大于64K字节，定义由RFC1323将该值必须设置在ServerSocket 之前它绑定到一个本地地址。这意味着，ServerSocket必须用无参数的构造函数创建的，然后setreceivebuffersize()必须被称为最后的支持是通过调用（）绑定到一个地址。
    
    不这样做不会造成错误，和缓冲区的大小可以设置为请求的值，但在接受这个ServerSocket套接字接收窗口的TCP将不大于64K字节。
    
    参数
    
    size的大小来设置接收缓冲区的大小。此值必须大于0。
    
    异常
    
    SocketException -如果在底层协议有错误，例如TCP错误。
    
    IllegalArgumentException -如果该值为0或为负。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    getReceiveBufferSize()
  - getReceiveBufferSize
```
public int getReceiveBufferSize()
                         throws SocketException
```
    得到这个 ServerSocket的 SO_RCVBUF期权的价值，即该缓冲区的大小，将用于接受来自这 ServerSocket
    注意，实际上在接受套接字的值是通过调用Socket.getReceiveBufferSize()确定。
    插座。
    
    结果
    
    为此 Socket的 SO_RCVBUF期权的价值。
    
    异常
    
    SocketException -如果在底层协议有错误，例如TCP错误。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    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表达低延迟的相对重要性
    
    bandwidth - int表达高带宽的相对重要性
    
    从以下版本开始：
    
    一点五

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class ServerSocket

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

ServerSocket

ServerSocket

ServerSocket

ServerSocket

方法详细信息

bind

bind

getInetAddress

getLocalPort

getLocalSocketAddress

accept

implAccept

close

getChannel

isBound

isClosed

setSoTimeout

getSoTimeout

setReuseAddress

getReuseAddress

toString

setSocketFactory

setReceiveBufferSize

getReceiveBufferSize

setPerformancePreferences