Spec-Zone.ru › OpenJDK 17

Класс 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() вместо этого.
Возвращает набор SocketOptions, поддерживаемых указанным типом сокета. Этот набор может включать стандартные параметры, а также нестандартные расширенные параметры.
Параметры:
socketType - тип сокета java.net
Возвращаемое значение:
Набор параметров сокета
Исключения:
IllegalArgumentException - если socketType не является допустимым типом сокета из пакета java.net.

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

Spec-Zone.ru

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