モジュール jdk.net

パッケージ jdk.net

クラスSockets

java.lang.Object

jdk.net.Sockets

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

非推奨。

Java SE 9では、ソケット・オプションを設定/取得し、ソケットごとにサポートされているオプションを取得して、このAPIを効率的に冗長化するための標準メソッドが追加されました。 対応するソケット・クラスで同等のメソッドを参照して、ソケット・オプションを設定/取得するか、使用可能なソケット・オプションを取得してください。

SocketOptionインタフェースで定義されるソケット・オプションを設定および取得するためのstaticメソッドを定義します。 Socket、ServerSocketおよびDatagramSocketで定義される標準オプションのすべてと、各ソケット・タイプでサポートされる追加オプションまたはプラットフォーム固有オプションをこの方法で設定できます。

supportedOptions(Class)メソッドを呼び出すと、現在のシステムで使用可能なオプション一式を(ソケット・タイプごとに)特定できます。

セキュリティ・マネージャがインストールされている場合、一部の非標準のソケット・オプションを設定または取得する前に、セキュリティ権限が必要になることがあります。 詳細はExtendedSocketOptionsで指定します。 StandardSocketOptionsには権限は不要です。

関連項目:

• NetworkChannel

メソッドのサマリー

修飾子と型	メソッド	説明
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()を使用してください。

クラス java.lang.Objectで宣言されたメソッド

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

メソッドの詳細

setOption

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

非推奨。

代わりにSocket.setOption(SocketOption, Object)を使用してください。

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

非推奨。

代わりにSocket.getOption(SocketOption)を使用してください。

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

型パラメータ:

T - ソケット・オプションのタイプ

パラメータ:

s - ソケット

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

戻り値:

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

例外:

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

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

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

NullPointerException - nameがnullである場合

関連項目:

• StandardSocketOptions

setOption

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

非推奨。

代わりにServerSocket.setOption(SocketOption, Object)を使用してください。

ServerSocketにソケット・オプションの値を設定します

型パラメータ:

T - ソケット・オプションのタイプ

パラメータ:

s - ソケット

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

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

例外:

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

IllegalArgumentException - 値がオプションに対して有効でない場合。

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

NullPointerException - nameがnullである場合

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

関連項目:

• StandardSocketOptions

getOption

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

非推奨。

代わりにServerSocket.getOption(SocketOption)を使用してください。

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

型パラメータ:

T - ソケット・オプションのタイプ

パラメータ:

s - ソケット

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

戻り値:

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

例外:

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

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

NullPointerException - nameがnullである場合

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

関連項目:

• StandardSocketOptions

setOption

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

非推奨。

代わりにDatagramSocket.setOption(SocketOption, Object)を使用してください。

DatagramSocketまたはMulticastSocketにソケット・オプションの値を設定します

型パラメータ:

T - ソケット・オプションのタイプ

パラメータ:

s - ソケット

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

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

例外:

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

IllegalArgumentException - 値がオプションに対して有効でない場合。

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

NullPointerException - nameがnullである場合

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

関連項目:

• StandardSocketOptions

getOption

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

非推奨。

代わりにDatagramSocket.getOption(SocketOption)を使用してください。

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

型パラメータ:

T - ソケット・オプションのタイプ

パラメータ:

s - ソケット

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

戻り値:

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

例外:

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

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

NullPointerException - nameがnullである場合

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

関連項目:

• StandardSocketOptions

supportedOptions

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

削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

かわりに、Socket.supportedOptions()、ServerSocket.supportedOptions()またはDatagramSocket.supportedOptions()を使用してください。

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

パラメータ:

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

戻り値:

ソケット・オプションのセット

例外:

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