java.lang.Object
jdk.net.Sockets
已弃用。
Java SE 9 添加了标准方法来设置/获取套接字选项,并检索每个套接字支持的选项,有效地使该 API 变得冗余。请参考相应的套接字类以获取设置/获取套接字选项或检索可用套接字选项的等效方法。
定义静态方法来设置和获取由
SocketOption 接口定义的套接字选项。 Socket 、ServerSocket 和 DatagramSocket 定义的所有标准选项,以及每个套接字类型支持的附加选项或平台特定选项都可以通过这种方式设置。
可以调用 supportedOptions(Class) 方法来确定当前系统上可用的完整选项集(每个套接字类型)。
安装安全管理器后,某些非标准套接字选项可能需要安全权限才能设置或获取。详细信息在 ExtendedSocketOptions 中指定。 StandardSocketOptions 不需要许可。
- 参见:
-
方法总结
修饰符和类型方法描述static <T> TgetOption(DatagramSocket s, SocketOption<T> name) 已弃用。static <T> TgetOption(ServerSocket s, SocketOption<T> name) 已弃用。static <T> TgetOption(Socket s, SocketOption<T> name) 已弃用。static <T> voidsetOption(DatagramSocket s, SocketOption<T> name, T value) 已弃用。static <T> voidsetOption(ServerSocket s, SocketOption<T> name, T value) 已弃用。static <T> voidsetOption(Socket s, SocketOption<T> name, T value) 已弃用。static Set<SocketOption<?>>supportedOptions(Class<?> socketType) 已弃用,将被删除:此 API 元素可能会在未来版本中删除。
-
方法详情
-
setOption
@Deprecated (since ="16") public static <T> void setOption(Socket s, SocketOption <T> name, T value) throws IOException 已弃用。在Socket上设置套接字选项的值- 类型参数:
T- 套接字选项的类型- 参数:
s- 插座name- 套接字选项value- 套接字选项的值。某些选项可能为空。- 抛出:
UnsupportedOperationException- 如果套接字不支持该选项。IllegalArgumentException- 如果该值对选项无效。IOException- 如果发生 I/O 错误,或套接字已关闭。SecurityException- 如果设置了安全管理器并且调用者没有任何必需的权限。NullPointerException- 如果名称为空- 参见:
-
getOption
@Deprecated (since ="16") public static <T> T getOption(Socket s, SocketOption <T> name) throws IOException 已弃用。从Socket返回套接字选项的值- 类型参数:
T- 套接字选项的类型- 参数:
s- 插座name- 套接字选项- 返回:
- 套接字选项的值。
- 抛出:
UnsupportedOperationException- 如果套接字不支持该选项。IOException- 如果发生 I/O 错误SecurityException- 如果设置了安全管理器并且调用者没有任何必需的权限。NullPointerException- 如果名称为空- 参见:
-
setOption
@Deprecated (since ="16") public static <T> void setOption(ServerSocket s, SocketOption <T> name, T value) throws IOException 已弃用。在ServerSocket上设置套接字选项的值- 类型参数:
T- 套接字选项的类型- 参数:
s- 插座name- 套接字选项value- 套接字选项的值- 抛出:
UnsupportedOperationException- 如果套接字不支持该选项。IllegalArgumentException- 如果该值对选项无效。IOException- 如果发生 I/O 错误NullPointerException- 如果名称为空SecurityException- 如果设置了安全管理器并且调用者没有任何必需的权限。- 参见:
-
getOption
@Deprecated (since ="16") public static <T> T getOption(ServerSocket s, SocketOption <T> name) throws IOException 已弃用。从ServerSocket返回套接字选项的值- 类型参数:
T- 套接字选项的类型- 参数:
s- 插座name- 套接字选项- 返回:
- 套接字选项的值。
- 抛出:
UnsupportedOperationException- 如果套接字不支持该选项。IOException- 如果发生 I/O 错误NullPointerException- 如果名称为空SecurityException- 如果设置了安全管理器并且调用者没有任何必需的权限。- 参见:
-
setOption
@Deprecated (since ="16") public static <T> void setOption(DatagramSocket s, SocketOption <T> name, T value) throws IOException 已弃用。在DatagramSocket或MulticastSocket上设置套接字选项的值- 类型参数:
T- 套接字选项的类型- 参数:
s- 插座name- 套接字选项value- 套接字选项的值- 抛出:
UnsupportedOperationException- 如果套接字不支持该选项。IllegalArgumentException- 如果该值对选项无效。IOException- 如果发生 I/O 错误NullPointerException- 如果名称为空SecurityException- 如果设置了安全管理器并且调用者没有任何必需的权限。- 参见:
-
getOption
@Deprecated (since ="16") public static <T> T getOption(DatagramSocket s, SocketOption <T> name) throws IOException 已弃用。从DatagramSocket或MulticastSocket返回套接字选项的值- 类型参数:
T- 套接字选项的类型- 参数:
s- 插座name- 套接字选项- 返回:
- 套接字选项的值。
- 抛出:
UnsupportedOperationException- 如果套接字不支持该选项。IOException- 如果发生 I/O 错误NullPointerException- 如果名称为空SecurityException- 如果设置了安全管理器并且调用者没有任何必需的权限。- 参见:
-
supportedOptions
@Deprecated (since ="16", forRemoval =true) public static Set <SocketOption <?>> supportedOptions(Class <?> socketType) 已弃用,将被删除:此 API 元素可能会在未来版本中删除。返回给定套接字类型支持的一组SocketOption。该套件可能包括标准选项和非标准扩展选项。- 参数:
socketType- java.net 套接字的类型- 返回:
- 一组套接字选项
- 抛出:
IllegalArgumentException- 如果 socketType 不是来自 java.net 包的有效套接字类型。
-