モジュール jdk.net

パッケージ jdk.net

クラスSockets

java.lang.Object

jdk.net.Sockets

public class Sockets
extends Object

SocketOptionインタフェースで定義されるソケット・オプションを設定および取得するためのstaticメソッドを定義します。 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(Class<?> 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 - 入出力エラーが発生した場合

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 - 入出力エラーが発生した場合

NullPointerException - nameがnullである場合

SecurityException - セキュリティ・マネージャが設定されているが、呼出し側に必要な権限がない場合。

関連項目:

StandardSocketOptions

getOption

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

ServerSocketからソケット・オプションの値を返します

パラメータ:

s - ソケット

name - ソケット・オプション

戻り値:

ソケット・オプションの値。

例外:

UnsupportedOperationException - ソケットがオプションをサポートしていない場合。

IOException - 入出力エラーが発生した場合

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 - 入出力エラーが発生した場合

NullPointerException - nameがnullである場合

SecurityException - セキュリティ・マネージャが設定されているが、呼出し側に必要な権限がない場合。

関連項目:

StandardSocketOptions

getOption

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

DatagramSocketまたはMulticastSocketからソケット・オプションの値を返します

パラメータ:

s - ソケット

name - ソケット・オプション

戻り値:

ソケット・オプションの値。

例外:

UnsupportedOperationException - ソケットがオプションをサポートしていない場合。

IOException - 入出力エラーが発生した場合

NullPointerException - nameがnullである場合

SecurityException - セキュリティ・マネージャが設定されているが、呼出し側に必要な権限がない場合。

関連項目:

StandardSocketOptions

supportedOptions

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

指定されたソケット・タイプがサポートするSocketOptionのセットを返します。 このセットには標準のオプションや非標準の拡張オプションが含まれます。

パラメータ:

socketType - java.netソケットのタイプ

例外:

IllegalArgumentException - socketTypeがjava.netパッケージの有効なソケット・タイプではない場合。