Spec-Zone.ru › OpenJDK 17

Класс ServerSocketFactory

java.lang.Object
javax.net.ServerSocketFactory
Прямые известные подклассы:
SSLServerSocketFactory
public abstract class ServerSocketFactory extends Object
Этот класс создаёт серверные сокеты. Он может быть расширен другими фабриками, которые создают определённые типы серверных сокетов. Это предоставляет общую основу для добавления общедоступной функциональности на уровне сокетов. Это аналог фабрики сокетов на стороне сервера и аналогичным образом предоставляет способ захвата различных политик, относящихся к создаваемым сокетам.

Как и фабрики сокетов, экземпляры фабрики серверных сокетов имеют методы для создания сокетов. Также существует стандартная по умолчанию фабрика серверных сокетов для конкретной среды; фреймворки часто используют свои собственные настроенные фабрики.

С момента:
1.4
См. также:
  • SocketFactory

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

ServerSocketFactory()
Модификатор Конструктор Описание
protected
Создаёт фабрику серверных сокетов.

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

Модификатор и тип Метод Описание
ServerSocket createServerSocket()
Возвращает свободный серверный сокет.
abstract ServerSocket createServerSocket(int port)
Возвращает серверный сокет, привязанный к указанному порту.
abstract ServerSocket createServerSocket(int port, int backlog)
Возвращает серверный сокет, привязанный к указанному порту, с указанным количеством ожидающих подключений.
abstract ServerSocket createServerSocket(int port, int backlog, InetAddress ifAddress)
Возвращает серверный сокет, привязанный к указанному порту, с указанным количеством ожидающих подключений и локальным IP-адресом.
static ServerSocketFactory getDefault()
Возвращает копию стандартной фабрики сокетов среды.

Методы, унаследованные от класса java.lang.Object

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

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

ServerSocketFactory

protected ServerSocketFactory()
Создаёт фабрику серверных сокетов.

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

getDefault

public static ServerSocketFactory getDefault()
Возвращает копию стандартной фабрики сокетов среды.
Возвращает:
the ServerSocketFactory

createServerSocket

public ServerSocket createServerSocket() throws IOException
Возвращает свободный серверный сокет. Сокет настроен с параметрами сокета (такими как таймаут ожидания подключения), заданными этой фабрикой.
Возвращает:
свободный сокет
Исключения:
IOException - если сокет не может быть создан
См. также:
  • ServerSocket.bind(java.net.SocketAddress)
  • ServerSocket.bind(java.net.SocketAddress, int)
  • ServerSocket()

createServerSocket

public abstract ServerSocket createServerSocket(int port) throws IOException
Возвращает серверный сокет, привязанный к указанному порту. Сокет настроен с параметрами сокета (такими как таймаут ожидания подключения), заданными этой фабрикой.

Если есть менеджер безопасности, его метод checkListen вызывается с аргументом port для обеспечения разрешения операции. Это может привести к SecurityException.

Параметры:
port - порт для прослушивания
Возвращает:
the ServerSocket
Исключения:
IOException - для сетевых ошибок
SecurityException - если менеджер безопасности существует и его метод checkListen не разрешает операцию.
IllegalArgumentException - если параметр порта находится вне заданного диапазона допустимых значений порта, который находится между 0 и 65535 включительно.
См. также:
  • SecurityManager.checkListen(int)
  • ServerSocket(int)

createServerSocket

public abstract ServerSocket createServerSocket(int port, int backlog) throws IOException
Возвращает серверный сокет, привязанный к указанному порту, и использует указанное количество ожидающих подключений. Сокет настроен с параметрами сокета (такими как таймаут ожидания подключения), заданными этой фабрикой.

Аргумент backlog должен быть положительным значением больше 0. Если переданное значение равно или меньше 0, то предполагается значение по умолчанию.

Если есть менеджер безопасности, его метод checkListen вызывается с аргументом port для обеспечения разрешения операции. Это может привести к SecurityException.

Параметры:
port - порт для прослушивания
backlog - количество ожидающих подключений
Возвращает:
the ServerSocket
Исключения:
IOException - для сетевых ошибок
SecurityException - если менеджер безопасности существует и его метод checkListen не разрешает операцию.
IllegalArgumentException - если параметр порта находится вне заданного диапазона допустимых значений порта, который находится между 0 и 65535 включительно.
См. также:
  • SecurityManager.checkListen(int)
  • ServerSocket(int, int)

createServerSocket

public abstract ServerSocket createServerSocket(int port, int backlog, InetAddress ifAddress) throws IOException
Возвращает серверный сокет, привязанный к указанному порту, с указанным количеством ожидающих подключений и локальным IP-адресом.

Аргумент ifAddress может использоваться на многоадресном узле для ServerSocket, который будет принимать запросы подключения только к одному из его адресов. Если ifAddress равно null, он будет принимать подключения ко всем локальным адресам. Сокет настроен с параметрами сокета (такими как таймаут ожидания подключения), заданными этой фабрикой.

Аргумент backlog должен быть положительным значением больше 0. Если переданное значение равно или меньше 0, то предполагается значение по умолчанию.

Если есть менеджер безопасности, его метод checkListen вызывается с аргументом port для обеспечения разрешения операции. Это может привести к SecurityException.

Параметры:
port - порт для прослушивания
backlog - количество ожидающих подключений
ifAddress - адрес сетевого интерфейса для использования
Возвращает:
the ServerSocket
Исключения:
IOException - для сетевых ошибок
SecurityException - если менеджер безопасности существует и его метод checkListen не разрешает операцию.
IllegalArgumentException - если параметр порта находится вне заданного диапазона допустимых значений порта, который находится между 0 и 65535 включительно.
См. также:
  • SecurityManager.checkListen(int)
  • ServerSocket(int, int, java.net.InetAddress)

© 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/java.base/javax/net/ServerSocketFactory.html

Spec-Zone.ru

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