java ServerSocket API 详解

2024-02-19 11:58
文章标签 java 详解 api serversocket

本文主要是介绍java ServerSocket API 详解,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

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

服务器套接字的实际工作由 SocketImpl 类的实例执行。应用程序可以更改创建套接字实现的套接字工厂来配置它自身,从而创建适合本地防火墙的套接字。

version1.90, 03/27/06
sinceJDK1.0
See alsojava.net.SocketImpl, setSocketFactory(java.net.SocketImplFactory), java.nio.channels.ServerSocketChannel


Constructors
publicServerSocket() throws IOException
zh_cn
创建非绑定服务器套接字。
ThrowsIOException: 
zh_cn
如果打开套接字时发生 IO 错误。
revised1.4
publicServerSocket(int port) throws IOException
zh_cn
创建绑定到特定端口的服务器套接字。端口 0 在所有空闲端口上创建套接字。

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

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

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

port
zh_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,则使用默认值。

port
zh_cn
指定的端口;或者为 0,表示使用任何空闲端口。
backlog
zh_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,则使用默认值。

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


Methods
public 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
如果此套接字具有关联的通道、通道处于非阻塞模式并且不存在准备接受的连接
return
zh_cn
新套接字
revised1.4
specJSR-51
See alsocheckAccept

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

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

endpoint
zh_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,则使用默认值。

endpoint
zh_cn
要绑定的 IP 地址和端口号。
backlog
zh_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.4
specJSR-51

final protected voidimplAccept(Socket s) throws IOException
zh_cn
ServerSocket 的子类使用此方法重写 accept() 以返回它们自己的套接字子类。因此,FooServerSocket 通常传递给此方法一个FooSocket。从 implAccept 返回时,FooSocket 将连接到客户端。
s
zh_cn
Socket
Throwsjava.nio.channels.IllegalBlockingModeException: 
zh_cn
如果此套接字具有关联通道并且通道处于非阻塞模式
ThrowsIOException: 
zh_cn
如果在等待连接时发生 I/O 错误。
sinceJDK1.1
revised1.4
specJSR-51
public StringtoString()
zh_cn
作为 String 返回此套接字的实现地址和实现端口。
return
zh_cn
此套接字的字符串表示形式。

Properties
public booleanisBound()
zh_cn
返回 ServerSocket 的绑定状态。
return
zh_cn
如果将 ServerSocket 成功地绑定到一个地址,则返回 true
since1.4
public ServerSocketChannelgetChannel()
zh_cn
返回与此套接字关联的唯一 java.nio.channels.ServerSocketChannel 对象(如果有)。

当且仅当通过 ServerSocketChannel.open 方法创建了通道本身时,服务器套接字才具有一个通道。

return
zh_cn
与此套接字关联的服务器套接字通道,如果没有为通道创建套接字,则返回 null
since1.4
specJSR-51

public booleanisClosed()
zh_cn
返回 ServerSocket 的关闭状态。
return
zh_cn
如果已经关闭了套接字,则返回 true
since1.4
public InetAddressgetInetAddress()
zh_cn
返回此服务器套接字的本地地址。
return
zh_cn
将此套接字绑定到的地址;如果套接字是未绑定的,则返回 null
public intgetLocalPort()
zh_cn
返回此套接字在其上侦听的端口。
return
zh_cn
此套接字侦听的端口号;如果尚未绑定套接字,则返回 -1。
public SocketAddressgetLocalSocketAddress()
zh_cn
返回此套接字绑定的端点的地址,如果尚未绑定则返回 null
return
zh_cn
表示此套接字的本地端点的 SocketAddress,如果尚未绑定则返回 null
since1.4
See 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) 调用此方法。

在绑定套接字后调用此方法无效。这意味着,需要利用无参数构造方法创建套接字才能使用此功能。

connectionTime
zh_cn
表明短连接时间的相对重要性的 int
latency
zh_cn
表明低延迟的相对重要性的 int
bandwidth
zh_cn
表明高带宽的相对重要性的 int
since1.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 错误。
size
zh_cn
要设置的接收缓冲区大小。此值必须大于 0。
ThrowsIllegalArgumentException: 
zh_cn
如果值为 0 或负。
since1.4
See alsogetReceiveBufferSize

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

注意,在接受的套接字中实际设置的值通过调用 Socket#getReceiveBufferSize() 来确定。

return
zh_cn
此 Socket 的 SO_RCVBUF 选项的值。
ThrowsSocketException: 
zh_cn
如果底层协议出现错误,例如 TCP 错误。
since1.4
See 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 时的行为是不确定的。

on
zh_cn
是否启用 SO_REUSEADDR 套接字选项
ThrowsSocketException: 
zh_cn
如果启用或禁用 SO_RESUEADDR 套接字选项时发生错误,或者关闭了套接字。
since1.4
See alsogetReuseAddress(), bind(SocketAddress), isBound(), isClosed()

public booleangetReuseAddress() throws SocketException
zh_cn
检测是否启用了 SO_REUSEADDR。
return
zh_cn
指示是否启用 SO_REUSEADDR 的 boolean 值。
ThrowsSocketException: 
zh_cn
如果底层协议出现错误,例如 TCP 错误。
since1.4
See alsosetReuseAddress(boolean)
public static voidsetSocketFactory(SocketImplFactory fac) throws IOException
zh_cn
为应用程序设置服务器套接字实现工厂。工厂只能指定一次。

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

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

如果有安全管理器,则此方法首先调用安全管理器的 checkSetFactory 方法,以确保允许进行此操作。这可能会导致 SecurityException 异常。

fac
zh_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 被解释为无穷大超时值。
timeout
zh_cn
指定的超时(以毫秒为单位)
ThrowsSocketException: 
zh_cn
如果底层协议出现错误,例如 TCP 错误。
sinceJDK1.1
See alsogetSoTimeout()
public intgetSoTimeout() throws IOException
zh_cn
获取 SO_TIMEOUT 的设置。返回 0 意味着禁用了选项(即无穷大的超时值)。
return
zh_cn
SO_TIMEOUT 值
ThrowsIOException: 
zh_cn
如果发生 I/O * 错误
sinceJDK1.1
See alsosetSoTimeout(int)

这篇关于java ServerSocket API 详解的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/724589

相关文章

C++使用栈实现括号匹配的代码详解

《C++使用栈实现括号匹配的代码详解》在编程中,括号匹配是一个常见问题,尤其是在处理数学表达式、编译器解析等任务时,栈是一种非常适合处理此类问题的数据结构,能够精确地管理括号的匹配问题,本文将通过C+... 目录引言问题描述代码讲解代码解析栈的状态表示测试总结引言在编程中,括号匹配是一个常见问题,尤其是在

Java实现检查多个时间段是否有重合

《Java实现检查多个时间段是否有重合》这篇文章主要为大家详细介绍了如何使用Java实现检查多个时间段是否有重合,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录流程概述步骤详解China编程步骤1:定义时间段类步骤2:添加时间段步骤3:检查时间段是否有重合步骤4:输出结果示例代码结语作

Java中String字符串使用避坑指南

《Java中String字符串使用避坑指南》Java中的String字符串是我们日常编程中用得最多的类之一,看似简单的String使用,却隐藏着不少“坑”,如果不注意,可能会导致性能问题、意外的错误容... 目录8个避坑点如下:1. 字符串的不可变性:每次修改都创建新对象2. 使用 == 比较字符串,陷阱满

Java判断多个时间段是否重合的方法小结

《Java判断多个时间段是否重合的方法小结》这篇文章主要为大家详细介绍了Java中判断多个时间段是否重合的方法,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录判断多个时间段是否有间隔判断时间段集合是否与某时间段重合判断多个时间段是否有间隔实体类内容public class D

IDEA编译报错“java: 常量字符串过长”的原因及解决方法

《IDEA编译报错“java:常量字符串过长”的原因及解决方法》今天在开发过程中,由于尝试将一个文件的Base64字符串设置为常量,结果导致IDEA编译的时候出现了如下报错java:常量字符串过长,... 目录一、问题描述二、问题原因2.1 理论角度2.2 源码角度三、解决方案解决方案①:StringBui

Java覆盖第三方jar包中的某一个类的实现方法

《Java覆盖第三方jar包中的某一个类的实现方法》在我们日常的开发中,经常需要使用第三方的jar包,有时候我们会发现第三方的jar包中的某一个类有问题,或者我们需要定制化修改其中的逻辑,那么应该如何... 目录一、需求描述二、示例描述三、操作步骤四、验证结果五、实现原理一、需求描述需求描述如下:需要在

Debezium 与 Apache Kafka 的集成方式步骤详解

《Debezium与ApacheKafka的集成方式步骤详解》本文详细介绍了如何将Debezium与ApacheKafka集成,包括集成概述、步骤、注意事项等,通过KafkaConnect,D... 目录一、集成概述二、集成步骤1. 准备 Kafka 环境2. 配置 Kafka Connect3. 安装 D

Java中ArrayList和LinkedList有什么区别举例详解

《Java中ArrayList和LinkedList有什么区别举例详解》:本文主要介绍Java中ArrayList和LinkedList区别的相关资料,包括数据结构特性、核心操作性能、内存与GC影... 目录一、底层数据结构二、核心操作性能对比三、内存与 GC 影响四、扩容机制五、线程安全与并发方案六、工程

JavaScript中的reduce方法执行过程、使用场景及进阶用法

《JavaScript中的reduce方法执行过程、使用场景及进阶用法》:本文主要介绍JavaScript中的reduce方法执行过程、使用场景及进阶用法的相关资料,reduce是JavaScri... 目录1. 什么是reduce2. reduce语法2.1 语法2.2 参数说明3. reduce执行过程

如何使用Java实现请求deepseek

《如何使用Java实现请求deepseek》这篇文章主要为大家详细介绍了如何使用Java实现请求deepseek功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录1.deepseek的api创建2.Java实现请求deepseek2.1 pom文件2.2 json转化文件2.2