Module jdk.net

软件包 jdk.net

Class Sockets

java.lang.Object

jdk.net.Sockets

public class Sockets
extends Object

定义静态方法来设置和获取由SocketOption界面定义的套接字选项。 所有的标准选项通过定义Socket ， ServerSocket ，并且DatagramSocket可以这样设置，以及由每个插槽类型支持附加的或特定于平台的选项。

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

安装安全管理器时，某些非标准套接字选项可能需要在设置或获取前获得安全许可。 细节在ExtendedSocketOptions中规定。 StandardSocketOptions不需要许可。

另请参见：

NetworkChannel

方法摘要

Modifier and Type	方法	描述
static <T> T	getOption(DatagramSocket s, SocketOption<T> name)	从DatagramSocket或MulticastSocket返回套接字选项的值
static <T> T	getOption(ServerSocket s, SocketOption<T> name)	从ServerSocket返回套接字选项的值
static <T> T	getOption(Socket s, SocketOption<T> name)	从Socket返回套接字选项的值
static <T> void	setOption(DatagramSocket s, SocketOption<T> name, T value)	在DatagramSocket或MulticastSocket上设置套接字选项的值
static <T> void	setOption(ServerSocket s, SocketOption<T> name, T value)	在ServerSocket上设置套接字选项的值
static <T> void	setOption(Socket s, SocketOption<T> name, T value)	在Socket上设置套接字选项的值
static Set<SocketOption<?>>	supportedOptions(Class<?> socketType)	返回给定套接字类型支持的一组SocketOption 。

Methods inherited from class java.lang.Object

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

方法详细信息

setOption

public static <T> void setOption(Socket s,
                                 SocketOption<T> name,
                                 T value)
                          throws IOException

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

参数

s - 套接字

name - 套接字选项

value - 套接字选项的值。 某些选项可能为空。

异常

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

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

IOException - 如果发生I / O错误，或者socket关闭。

SecurityException - 如果安全管理器已设置且呼叫者没有任何必需的权限。

NullPointerException - 如果name为null

另请参见：

StandardSocketOptions

getOption

public static <T> T getOption(Socket s,
                              SocketOption<T> name)
                       throws IOException

从Socket返回套接字选项的值

参数

s - 套接字

name - 套接字选项

结果

套接字选项的值。

异常

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

IOException - 如果发生I / O错误

SecurityException - 如果安全管理器已设置且呼叫者没有任何所需的权限。

NullPointerException - 如果name为null

另请参见：

StandardSocketOptions

setOption

public static <T> void setOption(ServerSocket s,
                                 SocketOption<T> name,
                                 T value)
                          throws IOException

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

参数

s - 套接字

name - 套接字选项

value - 套接字选项的值。

异常

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

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

IOException - 如果发生I / O错误

NullPointerException - 如果name为null

SecurityException - 如果安全管理器已设置且呼叫者没有任何必需的权限。

另请参见：

StandardSocketOptions

getOption

public static <T> T getOption(ServerSocket s,
                              SocketOption<T> name)
                       throws IOException

从ServerSocket返回套接字选项的值

参数

s - 套接字

name - 套接字选项

结果

套接字选项的值。

异常

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

IOException - 如果发生I / O错误

NullPointerException - 如果name为null

SecurityException - 如果设置了安全管理员，并且呼叫者没有任何所需的权限。

另请参见：

StandardSocketOptions

setOption

public static <T> void setOption(DatagramSocket s,
                                 SocketOption<T> name,
                                 T value)
                          throws IOException

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

参数

s - 套接字

name - 套接字选项

value - 套接字选项的值。

异常

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

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

IOException - 如果发生I / O错误

NullPointerException - 如果name为null

SecurityException - 如果安全管理器已设置且呼叫者没有任何必需的权限。

另请参见：

StandardSocketOptions

getOption

public static <T> T getOption(DatagramSocket s,
                              SocketOption<T> name)
                       throws IOException

从DatagramSocket或MulticastSocket返回套接字选项的值

参数

s - 套接字

name - 套接字选项

结果

套接字选项的值。

异常

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

IOException - 如果发生I / O错误

NullPointerException - 如果name为null

SecurityException - 如果设置了安全管理员，并且呼叫者没有任何必需的权限。

另请参见：

StandardSocketOptions

supportedOptions

public static Set<SocketOption<?>> supportedOptions(Class<?> socketType)

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

参数

socketType - java.net套接字的类型

异常

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