Spec-Zone.ru › OpenJDK 21

Класс ServerSocketFactory

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

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

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

Spec-Zone.ru

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