java ServerSocket API 详解

此类实现服务器套接字。服务器套接字等待请求通过网络传入。它基于该请求执行某些操作，然后可能向请求者返回结果。

服务器套接字的实际工作由 SocketImpl 类的实例执行。应用程序可以更改创建套接字实现的套接字工厂来配置它自身，从而创建适合本地防火墙的套接字。version1.90, 03/27/06sinceJDK1.0See alsojava.net.SocketImpl, setSocketFactory(java.net.SocketImplFactory), java.nio.channels.ServerSocketChannel

ConstructorspublicServerSocket() throws IOException
zh_cn创建非绑定服务器套接字。ThrowsIOException: zh_cn如果打开套接字时发生 IO 错误。revised1.4

publicServerSocket(int port) throws IOException
zh_cn创建绑定到特定端口的服务器套接字。端口 0 在所有空闲端口上创建套接字。

传入连接指示（对连接的请求）的最大队列长度被设置为 50。如果队列满时收到连接指示，则拒绝该连接。

如果应用程序已指定服务器套接字工厂，则调用该工厂的 createSocketImpl 方法来创建实际套接字实现。否则创建“普通”套接字。

如果存在安全管理器，则首先使用 port 参数作为参数调用其 checkListen 方法，以确保允许该操作。这可能会导致 SecurityException 异常。portzh_cn端口号；或者为 0，表示使用任何空闲端口。ThrowsIOException: zh_cn如果打开套接字时发生 I/O 错误。ThrowsSecurityException: zh_cn如果安全管理器存在并且其 checkListen 方法不允许进行该操作。See alsojava.net.SocketImpl, createSocketImpl(), setSocketFactory(java.net.SocketImplFactory), checkListen

publicServerSocket(int port, int backlog) throws IOException
zh_cn利用指定的 backlog 创建服务器套接字并将其绑定到指定的本地端口号。端口号 0 在所有空闲端口上创建套接字。

传入连接指示（对连接的请求）的最大队列长度被设置为 backlog 参数。如果队列满时收到连接指示，则拒绝该连接。

如果应用程序已指定服务器套接字工厂，则调用该工厂的 createSocketImpl 方法来创建实际套接字实现。否则创建“普通”套接字。

如果存在安全管理器，则首先使用 port 参数作为参数调用其 checkListen 方法，以确保允许该操作。这可能会导致 SecurityException 异常。

backlog 参数必须是大于 0 的正值。如果传递的值等于或小于 0，则使用默认值。

portzh_cn指定的端口；或者为 0，表示使用任何空闲端口。backlogzh_cn队列的最大长度。ThrowsIOException: zh_cn如果打开套接字时发生 I/O 错误。ThrowsSecurityException: zh_cn如果安全管理器存在并且其 checkListen 方法不允许进行该操作。See alsojava.net.SocketImpl, createSocketImpl(), setSocketFactory(java.net.SocketImplFactory), checkListen

publicServerSocket(int port, int backlog, InetAddress bindAddr) throws IOException
zh_cn使用指定的端口、侦听 backlog 和要绑定到的本地 IP 地址创建服务器。bindAddr 参数可以在 ServerSocket 的多宿主主机 (multi-homed host) 上使用，ServerSocket 仅接受对其地址之一的连接请求。如果 bindAddr 为 null，则默认接受任何/所有本地地址上的连接。端口必须在 0 到 65535 之间（包括两者）。

如果存在安全管理器，则此方法使用 port 作为参数调用其 checkListen 方法，以确保允许该操作。这可能会导致 SecurityException 异常。

backlog 参数必须是大于 0 的正值。如果传递的值等于或小于 0，则使用默认值。

portzh_cn本地 TCP 端口backlogzh_cn侦听 backlogbindAddrzh_cn要将服务器绑定到的 InetAddressThrowsSecurityException: zh_cn如果安全管理器存在并且其 checkListen 方法不允许进行该操作。ThrowsIOException: zh_cn如果打开套接字时发生 I/O 错误。sinceJDK1.1See alsojava.net.SocketOptions, java.net.SocketImpl, checkListen

Methodspublic Socketaccept() throws IOException
zh_cn侦听并接受到此套接字的连接。此方法在连接传入之前一直阻塞。

创建新套接字 s，如果存在安全管理器，则使用 s.getInetAddress().getHostAddress() 和 s.getPort() 作为参数调用安全管理器的checkAccept 方法，以确保允许该操作。这可能会导致 SecurityException 异常。ThrowsIOException: zh_cn如果等待连接时发生 I/O 错误。ThrowsSecurityException: zh_cn如果安全管理器存在并且其 checkAccept 方法不允许进行该操作。ThrowsSocketTimeoutException: zh_cn如果以前使用 setSoTimeout 设置了超时并且已到达超时值。Throwsjava.nio.channels.IllegalBlockingModeException: zh_cn如果此套接字具有关联的通道、通道处于非阻塞模式并且不存在准备接受的连接returnzh_cn新套接字revised1.4specJSR-51See alsocheckAccept

public voidbind(SocketAddress endpoint) throws IOException
zh_cn将 ServerSocket 绑定到特定地址（IP 地址和端口号）。

如果地址为 null，则系统将挑选一个临时端口和一个有效本地地址来绑定套接字。

endpointzh_cn要绑定的 IP 地址和端口号。ThrowsIOException: zh_cn如果绑定操作失败或者已经绑定了套接字。ThrowsSecurityException: zh_cn如果 SecurityManager 存在并且其 checkListen 方法不允许该操作。ThrowsIllegalArgumentException: zh_cn如果端点是不受此套接字支持的 SocketAddress 子类since1.4

public voidbind(SocketAddress endpoint, int backlog) throws IOException
zh_cn将 ServerSocket 绑定到特定地址（IP 地址和端口号）。

如果地址为 null，则系统将挑选一个临时端口和一个有效本地地址来绑定套接字。

backlog 参数必须是大于 0 的正值。如果传递的值等于或小于 0，则使用默认值。endpointzh_cn要绑定的 IP 地址和端口号。backlogzh_cn侦听 backlog 长度。ThrowsIOException: zh_cn如果绑定操作失败或者已经绑定了套接字。ThrowsSecurityException: zh_cn如果 SecurityManager 存在并且其 checkListen 方法不允许该操作。ThrowsIllegalArgumentException: zh_cn如果端点是不受此套接字支持的 SocketAddress 子类since1.4

public voidclose() throws IOException
zh_cn关闭此套接字。 在 #accept() 中所有当前阻塞的线程都将会抛出 SocketException。

如果此套接字有一个与之关联的通道，则关闭该通道。ThrowsIOException: zh_cn如果关闭套接字时发生 I/O 错误。revised1.4specJSR-51

final protected voidimplAccept(Socket s) throws IOException
zh_cnServerSocket 的子类使用此方法重写 accept() 以返回它们自己的套接字子类。因此，FooServerSocket 通常传递给此方法一个空FooSocket。从 implAccept 返回时，FooSocket 将连接到客户端。szh_cnSocketThrowsjava.nio.channels.IllegalBlockingModeException: zh_cn如果此套接字具有关联通道并且通道处于非阻塞模式ThrowsIOException: zh_cn如果在等待连接时发生 I/O 错误。sinceJDK1.1revised1.4specJSR-51

public StringtoString()
zh_cn作为 String 返回此套接字的实现地址和实现端口。returnzh_cn此套接字的字符串表示形式。

Propertiespublic booleanisBound()
zh_cn返回 ServerSocket 的绑定状态。returnzh_cn如果将 ServerSocket 成功地绑定到一个地址，则返回 truesince1.4

public ServerSocketChannelgetChannel()
zh_cn返回与此套接字关联的唯一 java.nio.channels.ServerSocketChannel 对象（如果有）。

当且仅当通过 ServerSocketChannel.open 方法创建了通道本身时，服务器套接字才具有一个通道。returnzh_cn与此套接字关联的服务器套接字通道，如果没有为通道创建套接字，则返回 null。since1.4specJSR-51

public booleanisClosed()
zh_cn返回 ServerSocket 的关闭状态。returnzh_cn如果已经关闭了套接字，则返回 truesince1.4

public InetAddressgetInetAddress()
zh_cn返回此服务器套接字的本地地址。returnzh_cn将此套接字绑定到的地址；如果套接字是未绑定的，则返回 null。

public intgetLocalPort()
zh_cn返回此套接字在其上侦听的端口。returnzh_cn此套接字侦听的端口号；如果尚未绑定套接字，则返回 -1。

public SocketAddressgetLocalSocketAddress()
zh_cn返回此套接字绑定的端点的地址，如果尚未绑定则返回 null。returnzh_cn表示此套接字的本地端点的 SocketAddress，如果尚未绑定则返回 null。since1.4See alsogetInetAddress(), getLocalPort(), bind(SocketAddress)

public voidsetPerformancePreferences(int connectionTime, int latency, int bandwidth)
zh_cn设置此 ServerSocket 的性能首选项。

默认情况下套接字使用 TCP/IP 协议。有些实现可能提供与 TCP/IP 具有不同性能特征的替代协议。此方法允许应用程序在实现从可用协议中作出选择时表明它自己关于应该如何进行折衷的首选项。

性能首选项由三个整数描述，它们的值分别指示短连接时间、低延迟和高带宽的相对重要性。这些整数的绝对值没有意义；为了选择协议，需要简单地比较它们的值，较大的值指示更强的首选项。例如，如果应用程序相对于低延迟和高带宽更希望短连接时间，则其可以使用值 (1, 0, 0) 调用此方法。如果应用程序相对于低延迟更希望高带宽，且相对于短连接时间更希望低延迟，则其可以使用值 (0, 1, 2) 调用此方法。

在绑定套接字后调用此方法无效。这意味着，需要利用无参数构造方法创建套接字才能使用此功能。connectionTimezh_cn表明短连接时间的相对重要性的 intlatencyzh_cn表明低延迟的相对重要性的 intbandwidthzh_cn表明高带宽的相对重要性的 intsince1.5

public voidsetReceiveBufferSize(int size) throws SocketException
zh_cn为从此 ServerSocket 接受的套接字的 SO_RCVBUF 选项设置默认建议值。在接受的套接字中实际设置的值必须在 #accept() 返回套接字后通过调用 Socket#getReceiveBufferSize() 确定。

SO_RCVBUF 的值用于设置内部套接字接收缓冲区的大小和设置公布到远程同位体的 TCP 接收窗口的大小。

随后可以通过调用 Socket#setReceiveBufferSize(int) 更改该值。但是，如果应用程序希望允许大于 RFC1323 中定义的 64K 字节的接收窗口，则在将 ServerSocket 绑定到本地地址之前必须在其中设置建议值。这意味着，必须用无参数构造方法创建 ServerSocket，然后必须调用 setReceiveBufferSize()，最后通过调用 bind() 将 ServerSocket 绑定到地址。

未能执行此操作不会导致错误，缓冲区大小可能被设置为所请求的值，但是从此 ServerSocket 中接受的套接字中的 TCP 接收窗口将不再大于 64K 字节。ThrowsSocketException: zh_cn如果底层协议出现错误，例如 TCP 错误。sizezh_cn要设置的接收缓冲区大小。此值必须大于 0。ThrowsIllegalArgumentException: zh_cn如果值为 0 或负。since1.4See alsogetReceiveBufferSize

public intgetReceiveBufferSize() throws SocketException
zh_cn获取此 ServerSocket 的 SO_RCVBUF 选项的值，该值是将用于从此 ServerSocket 接受的套接字的建议缓冲区大小。

注意，在接受的套接字中实际设置的值通过调用 Socket#getReceiveBufferSize() 来确定。returnzh_cn此 Socket 的 SO_RCVBUF 选项的值。ThrowsSocketException: zh_cn如果底层协议出现错误，例如 TCP 错误。since1.4See alsosetReceiveBufferSize(int)

public voidsetReuseAddress(boolean on) throws SocketException
zh_cn启用/禁用 SO_REUSEADDR 套接字选项。

关闭 TCP 连接时，该连接可能在关闭后的一段时间内保持超时状态（通常称为 TIME_WAIT 状态或 2MSL 等待状态）。对于使用已知套接字地址或端口的应用程序而言，如果存在处于超时状态的连接（包括地址和端口），可能不能将套接字绑定到所需的 SocketAddress。

在使用 #bind(SocketAddress) 绑定套接字前启用 SO_REUSEADDR 可允许上一个连接处于超时状态时绑定套接字。

当创建 ServerSocket 时，SO_REUSEADDR 的初始设置是不确定的。应用程序可以使用 #getReuseAddress() 来确定 SO_REUSEADDR 的初始设置。

在绑定套接字（请参阅 #isBound()）后启用或禁用 SO_REUSEADDR 时的行为是不确定的。onzh_cn是否启用 SO_REUSEADDR 套接字选项ThrowsSocketException: zh_cn如果启用或禁用 SO_RESUEADDR 套接字选项时发生错误，或者关闭了套接字。since1.4See alsogetReuseAddress(), bind(SocketAddress), isBound(), isClosed()

public booleangetReuseAddress() throws SocketException
zh_cn检测是否启用了 SO_REUSEADDR。returnzh_cn指示是否启用 SO_REUSEADDR 的 boolean 值。ThrowsSocketException: zh_cn如果底层协议出现错误，例如 TCP 错误。since1.4See alsosetReuseAddress(boolean)

public static voidsetSocketFactory(SocketImplFactory fac) throws IOException
zh_cn为应用程序设置服务器套接字实现工厂。工厂只能指定一次。

当应用程序创建新的服务器套接字时，调用套接字实现工厂的 createSocketImpl 方法创建实际的套接字实现。

除非已经设置了工厂，否则向该方法传递 null 是无操作。

如果有安全管理器，则此方法首先调用安全管理器的 checkSetFactory 方法，以确保允许进行此操作。这可能会导致 SecurityException 异常。faczh_cn所需的工厂。ThrowsIOException: zh_cn如果设置套接字工厂时发生 I/O 错误。ThrowsSocketException: zh_cn如果已经定义该工厂。ThrowsSecurityException: zh_cn如果安全管理器存在并且其 checkSetFactory 方法不允许进行此操作。See alsocreateSocketImpl(), checkSetFactory

public voidsetSoTimeout(int timeout) throws SocketException
zh_cn通过指定超时值启用/禁用 SO_TIMEOUT，以毫秒为单位。将此选项设为非零的超时值时，对此 ServerSocket 调用 accept() 将只阻塞此时间长度。如果超过超时值，将引发 java.net.SocketTimeoutException，虽然 ServerSocket 仍旧有效。选项必须在进入阻塞操作前被启用才能生效。超时值必须是 > 0 的数。超时值为 0 被解释为无穷大超时值。timeoutzh_cn指定的超时（以毫秒为单位）ThrowsSocketException: zh_cn如果底层协议出现错误，例如 TCP 错误。sinceJDK1.1See alsogetSoTimeout()

public intgetSoTimeout() throws IOException
zh_cn获取 SO_TIMEOUT 的设置。返回 0 意味着禁用了选项（即无穷大的超时值）。returnzh_cnSO_TIMEOUT 值ThrowsIOException: zh_cn如果发生 I/O * 错误sinceJDK1.1See alsosetSoTimeout(int)