Module jdk.net

Package jdk.net

Class Sockets

java.lang.Object

jdk.net.Sockets

       @Deprecated(since="16") public class Sockets extends Object
      

Deprecated.

Java SE 9 added standard methods to set/get socket options, and retrieve the per-Socket supported options effectively rendering this API redundant. Please refer to the corresponding socket's class for the equivalent method to set/get a socket option or retrieve available socket options.

定义了设置和获取由SocketOption接口定义的套接字选项的静态方法。所有由Socket、ServerSocket和DatagramSocket定义的标准选项都可以通过这种方式设置，以及每种套接字类型支持的其他或特定于平台的选项。

可以调用supportedOptions(Class)方法来确定当前系统上可用的完整选项集（每种套接字类型）。

当安装了安全管理器时，一些非标准的套接字选项可能需要在设置或获取之前获得安全权限。详细信息在ExtendedSocketOptions中指定。对于StandardSocketOptions不需要权限。

参见:

• NetworkChannel

Method Summary

Modifier and Type	Method	Description
static <T> T	getOption(DatagramSocket s, SocketOption<T> name)	已过时。 使用DatagramSocket.getOption(SocketOption)代替。
static <T> T	getOption(ServerSocket s, SocketOption<T> name)	已过时。 使用ServerSocket.getOption(SocketOption)代替。
static <T> T	getOption(Socket s, SocketOption<T> name)	已过时。 使用Socket.getOption(SocketOption)代替。
static <T> void	setOption(DatagramSocket s, SocketOption<T> name, T value)	已过时。 使用DatagramSocket.setOption(SocketOption, Object)代替。
static <T> void	setOption(ServerSocket s, SocketOption<T> name, T value)	已过时。 使用ServerSocket.setOption(SocketOption, Object)代替。
static <T> void	setOption(Socket s, SocketOption<T> name, T value)	已过时。 使用Socket.setOption(SocketOption, Object)代替。
static Set<SocketOption<?>>	supportedOptions(Class<?> socketType)	已过时，将来会移除：此API元素可能在将来的版本中被移除。 使用Socket.supportedOptions()、ServerSocket.supportedOptions()或DatagramSocket.supportedOptions()代替。

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

setOption

             @Deprecated(since="16") public static <T> void setOption(Socket s, SocketOption<T> name, T value) throws IOException
            

Deprecated.

use Socket.setOption(SocketOption, Object) instead.

在Socket上设置套接字选项的值

类型参数:

T - 套接字选项的类型

参数:

s - 套接字

name - 套接字选项

value - 套接字选项的值。对于某些选项，可能为null。

抛出:

UnsupportedOperationException - 如果套接字不支持该选项。

IllegalArgumentException - 如果值对于该选项无效。

IOException - 如果发生I/O错误，或套接字已关闭。

SecurityException - 如果设置了安全管理器且调用方没有任何所需权限。

NullPointerException - 如果name为null

参见:

• StandardSocketOptions

getOption

             @Deprecated(since="16") public static <T> T getOption(Socket s, SocketOption<T> name) throws IOException
            

Deprecated.

use Socket.getOption(SocketOption) instead.

从Socket返回套接字选项的值

类型参数:

T - 套接字选项的类型

参数:

s - 套接字

name - 套接字选项

返回:

套接字选项的值。

抛出:

UnsupportedOperationException - 如果套接字不支持该选项。

IOException - 如果发生I/O错误

SecurityException - 如果设置了安全管理器且调用方没有任何所需权限。

NullPointerException - 如果name为null

参见:

• StandardSocketOptions

setOption

             @Deprecated(since="16") public static <T> void setOption(ServerSocket s, SocketOption<T> name, T value) throws IOException
            

Deprecated.

use ServerSocket.setOption(SocketOption, Object) instead.

在ServerSocket上设置套接字选项的值

类型参数:

T - 套接字选项的类型

参数:

s - 套接字

name - 套接字选项

value - 套接字选项的值

抛出:

UnsupportedOperationException - 如果套接字不支持该选项。

IllegalArgumentException - 如果值对于该选项无效。

IOException - 如果发生I/O错误

NullPointerException - 如果name为null

SecurityException - 如果设置了安全管理器且调用方没有任何所需权限。

参见:

• StandardSocketOptions

getOption

             @Deprecated(since="16") public static <T> T getOption(ServerSocket s, SocketOption<T> name) throws IOException
            

Deprecated.

use ServerSocket.getOption(SocketOption) instead.

从ServerSocket返回套接字选项的值

类型参数:

T - 套接字选项的类型

参数:

s - 套接字

name - 套接字选项

返回:

套接字选项的值。

抛出:

UnsupportedOperationException - 如果套接字不支持该选项。

IOException - 如果发生I/O错误

NullPointerException - 如果name为null

SecurityException - 如果设置了安全管理器且调用方没有任何所需权限。

参见:

• StandardSocketOptions

setOption

             @Deprecated(since="16") public static <T> void setOption(DatagramSocket s, SocketOption<T> name, T value) throws IOException
            

Deprecated.

use DatagramSocket.setOption(SocketOption, Object) instead.

在DatagramSocket或MulticastSocket上设置套接字选项的值

类型参数:

T - 套接字选项的类型

参数:

s - 套接字

name - 套接字选项

value - 套接字选项的值

抛出:

UnsupportedOperationException - 如果套接字不支持该选项。

IllegalArgumentException - 如果值对于该选项无效。

IOException - 如果发生I/O错误

NullPointerException - 如果name为null

SecurityException - 如果设置了安全管理器且调用方没有任何所需权限。

参见:

• StandardSocketOptions

getOption

             @Deprecated(since="16") public static <T> T getOption(DatagramSocket s, SocketOption<T> name) throws IOException
            

Deprecated.

use DatagramSocket.getOption(SocketOption) instead.

返回来自DatagramSocket或MulticastSocket的套接字选项的值。

类型参数：

T - 套接字选项的类型

参数：

s - 套接字

name - 套接字选项

返回：

套接字选项的值。

抛出：

UnsupportedOperationException - 如果套接字不支持该选项。

IOException - 如果发生I/O错误

NullPointerException - 如果name为null

SecurityException - 如果设置了安全管理器且调用者没有所需的权限。

参见：

• StandardSocketOptions

supportedOptions

             @Deprecated(since="16", forRemoval=true) public static Set<SocketOption<?>> supportedOptions(Class<?> socketType)
            

Deprecated, for removal: This API element is subject to removal in a future version.

use Socket.supportedOptions(), ServerSocket.supportedOptions(), or DatagramSocket.supportedOptions() instead.

返回给定套接字类型支持的一组SocketOption。此集合可能包括标准选项和非标准扩展选项。

参数：

socketType - java.net套接字的类型

返回：

一组套接字选项

抛出：

IllegalArgumentException - 如果socketType不是java.net包中的有效套接字类型。