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要素は、将来のバージョンで削除される可能性があります。
-
メソッドの詳細
-
setOption
@Deprecated(since="16")public static <T> void setOption(Socket s, SocketOption<T> name, T value) throws IOException非推奨。代わりにSocket.setOption(SocketOption, Object)
を使用してください。Socket
にソケット・オプションの値を設定します- パラメータ:
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
からソケット・オプションの値を返します- パラメータ:
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
にソケット・オプションの値を設定します- パラメータ:
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
からソケット・オプションの値を返します- パラメータ:
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
にソケット・オプションの値を設定します- パラメータ:
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
からソケット・オプションの値を返します- パラメータ:
s
- ソケットname
- ソケット・オプション- 戻り値:
- ソケット・オプションの値。
- 例外:
UnsupportedOperationException
- ソケットがオプションをサポートしていない場合。IOException
- 入出力エラーが発生した場合NullPointerException
- nameがnullである場合SecurityException
- セキュリティ・マネージャが設定されているが、呼出し側に必要な権限がない場合。- 関連項目:
StandardSocketOptions
-
supportedOptions
@Deprecated(since="16", forRemoval=true)public static Set<SocketOption<?>> supportedOptions(Class<?> socketType)削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。指定されたソケット・タイプがサポートするSocketOption
のセットを返します。 このセットには標準のオプションや非標準の拡張オプションが含まれます。- パラメータ:
socketType
- java.netソケットのタイプ- 例外:
IllegalArgumentException
- socketTypeがjava.netパッケージの有効なソケット・タイプではない場合。
-