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(クラス<?> socketType)
指定されたソケット・タイプがサポートするSocketOption
のセットを返します。
-
メソッドの詳細
-
setOption
public static <T> void setOption(Socket s, SocketOption<T> name, T value) throws IOExceptionSocket
にソケット・オプションの値を設定します- パラメータ:
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 IOExceptionSocket
からソケット・オプションの値を返します- パラメータ:
s
- ソケットname
- ソケット・オプション- 戻り値:
- ソケット・オプションの値。
- 例外:
UnsupportedOperationException
- ソケットがオプションをサポートしていない場合。IOException
- 入出力エラーが発生した場合SecurityException
- セキュリティ・マネージャが設定されているが、呼出し側に必要な権限がない場合。NullPointerException
- nameがnullである場合- 関連項目:
StandardSocketOptions
-
setOption
public static <T> void setOption(ServerSocket s, SocketOption<T> name, T value) throws IOExceptionServerSocket
にソケット・オプションの値を設定します- パラメータ:
s
- ソケットname
- ソケット・オプションvalue
- ソケット・オプションの値。- 例外:
UnsupportedOperationException
- ソケットがオプションをサポートしていない場合。IllegalArgumentException
- 値がオプションに対して有効でない場合。IOException
- 入出力エラーが発生した場合NullPointerException
- nameがnullである場合SecurityException
- セキュリティ・マネージャが設定されているが、呼出し側に必要な権限がない場合。- 関連項目:
StandardSocketOptions
-
getOption
public static <T> T getOption(ServerSocket s, SocketOption<T> name) throws IOExceptionServerSocket
からソケット・オプションの値を返します- パラメータ:
s
- ソケットname
- ソケット・オプション- 戻り値:
- ソケット・オプションの値。
- 例外:
UnsupportedOperationException
- ソケットがオプションをサポートしていない場合。IOException
- 入出力エラーが発生した場合NullPointerException
- nameがnullである場合SecurityException
- セキュリティ・マネージャが設定されているが、呼出し側に必要な権限がない場合。- 関連項目:
StandardSocketOptions
-
setOption
public static <T> void setOption(DatagramSocket s, SocketOption<T> name, T value) throws IOExceptionDatagramSocket
またはMulticastSocket
にソケット・オプションの値を設定します- パラメータ:
s
- ソケットname
- ソケット・オプションvalue
- ソケット・オプションの値。- 例外:
UnsupportedOperationException
- ソケットがオプションをサポートしていない場合。IllegalArgumentException
- 値がオプションに対して有効でない場合。IOException
- 入出力エラーが発生した場合NullPointerException
- nameがnullである場合SecurityException
- セキュリティ・マネージャが設定されているが、呼出し側に必要な権限がない場合。- 関連項目:
StandardSocketOptions
-
getOption
public static <T> T getOption(DatagramSocket s, SocketOption<T> name) throws IOExceptionDatagramSocket
または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パッケージの有効なソケット・タイプではない場合。
-