Класс 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​(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 - если произошла ошибка ввода-вывода или сокет закрыт.
SecurityException - если установлен менеджер безопасности, и у вызывающего объекта отсутствуют необходимые разрешения.
NullPointerException - если имя равно null
См. также:
StandardSocketOptions

getOption

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

Возвращает значение параметра сокета для Socket

Параметры:
s - сокет
name - параметр сокета
Возвращает:
Значение параметра сокета.
Исключения:
UnsupportedOperationException - если сокет не поддерживает параметр.
IOException - если произошла ошибка ввода-вывода.
SecurityException - если установлен менеджер безопасности, и у вызывающего объекта отсутствуют необходимые разрешения.
NullPointerException - если имя равно 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 - если имя равно null
SecurityException - если установлен менеджер безопасности, и у вызывающего объекта отсутствуют необходимые разрешения.
См. также:
StandardSocketOptions

getOption

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

Возвращает значение параметра сокета для ServerSocket

Параметры:
s - сокет
name - параметр сокета
Возвращает:
Значение параметра сокета.
Исключения:
UnsupportedOperationException - если сокет не поддерживает параметр.
IOException - если произошла ошибка ввода-вывода.
NullPointerException - если имя равно 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 - если имя равно null
SecurityException - если установлен менеджер безопасности, и у вызывающего объекта отсутствуют необходимые разрешения.
См. также:
StandardSocketOptions

getOption

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

Возвращает значение параметра сокета для DatagramSocket или MulticastSocket

Параметры:
s - сокет
name - параметр сокета
Возвращает:
Значение параметра сокета.
Исключения:
UnsupportedOperationException - если сокет не поддерживает параметр.
IOException - если произошла ошибка ввода-вывода.
NullPointerException - если имя равно null
SecurityException - если установлен менеджер безопасности, и у вызывающего объекта отсутствуют необходимые разрешения.
См. также:
StandardSocketOptions

supportedOptions

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

Возвращает набор SocketOption, поддерживаемых данным типом сокета. Этот набор может включать стандартные параметры, а также нестандартные расширенные параметры.

Параметры:
socketType - тип сокета java.net
Исключения:
IllegalArgumentException - если socketType не является допустимым типом сокета из пакета java.net.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/jdk.net/jdk/net/Sockets.html

Spec-Zone .ru
спецификации, руководства, описания, API