模块 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

方法摘要

变量和类型	方法	描述
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(类<?> socketType)	返回给定套接字类型支持的一组SocketOption 。

声明方法的类 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 - 套接字选项的值。 某些选项可能为null。

异常

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

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

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

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(类<?> socketType)

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

参数

socketType - java.net套接字的类型

异常

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