Spec-Zone.ru › OpenJDK 21

Класс 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) может быть вызван для определения полного набора доступных параметров (для каждого типа сокета) на текущей системе.

При установке менеджера безопасности, некоторые нестандартные параметры сокета могут потребовать разрешения безопасности перед установкой или получением. Подробности указаны в 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 - если произошла ошибка ввода-вывода или сокет закрыт.
SecurityException - если установлен менеджер безопасности и у вызывающего объекта нет необходимых разрешений.
NullPointerException - если имя равно 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 - если имя равно 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 - если имя равно 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 - если имя равно 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 - если имя равно 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 - если имя равно 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.

© 1993, 2023, 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/21/docs/api/jdk.net/jdk/net/Sockets.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API