Класс Sockets

java.lang.Object

jdk.net.Sockets

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

Устарело.

В Java SE 9 были добавлены стандартные методы для установки и получения параметров сокета, а также для получения поддерживаемых параметров каждого сокета, что фактически сделало этот API избыточным. Эквивалентные методы установки и получения параметров сокета или получения доступных параметров см. в документации соответствующего класса сокета.

Определяет статические методы для установки и получения параметров сокета, определённых интерфейсом SocketOption. Таким способом можно задавать все стандартные параметры, определённые для Socket, ServerSocket и DatagramSocket, а также дополнительные или платформозависимые параметры, поддерживаемые каждым типом сокета.

Для определения полного набора доступных в текущей системе параметров (для каждого типа сокета) можно вызвать метод supportedOptions(Class).

Начиная с версии:

1.8

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`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()`.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание методов

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 — если произошла ошибка ввода-вывода или сокет закрыт.

NullPointerException — если имя равно null

См. также:

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 — если произошла ошибка ввода-вывода

NullPointerException — если имя равно null

См. также:

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 — если имя равно null

См. также:

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 — если имя равно null

См. также:

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 — если имя равно null

См. также:

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 — если имя равно null

См. также:

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.

© 1993, 2025, 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.