Класс ServerSocketFactory

Прямые известные подклассы:
SSLServerSocketFactory
public abstract class ServerSocketFactory
extends Object

Этот класс создаёт сокеты сервера. Он может быть унаследован другими фабриками, которые создают определённые типы сокетов сервера. Это обеспечивает общий каркас для добавления публичных функциональных возможностей на уровне сокетов. Это аналог фабрики сокетов со стороны сервера, аналогично предоставляющий способ захвата различных политик, связанных с создаваемыми сокетами.

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

С тех пор:
1.4
См. также:
SocketFactory

Конструкторы

МодификаторКонструкторОписание
protected ServerSocketFactory()

Создаёт фабрику сокетов сервера.

Методы

Модификатор и типМетодОписание
ServerSocketcreateServerSocket()

Возвращает свободный сокет сервера.

abstract ServerSocketcreateServerSocket​(int port)

Возвращает сокет сервера, привязанный к указанному порту.

abstract ServerSocketcreateServerSocket​(int port, int backlog)

Возвращает сокет сервера, привязанный к указанному порту и использующий указанный бэклогинг соединения.

abstract ServerSocketcreateServerSocket​(int port, int backlog, InetAddress ifAddress)

Возвращает сокет сервера, привязанный к указанному порту, с указанным бэклогингом и локальным IP-адресом.

static ServerSocketFactorygetDefault()

Возвращает копию фабрики сокетов по умолчанию среды.

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

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

Конструкторы

ServerSocketFactory

protected ServerSocketFactory()

Создаёт фабрику сокетов сервера.

Методы

getDefault

public static ServerSocketFactory getDefault()

Возвращает копию фабрики сокетов по умолчанию среды.

Возвращает:
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 - порт для прослушивания
Возвращает:
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 - количество подключений в очереди
Возвращает:
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 - адрес сетевого интерфейса для использования
Возвращает:
ServerSocket
Исключение:
IOException - для сетевых ошибок
SecurityException - если менеджер безопасности существует и его метод checkListen не разрешает операцию.
IllegalArgumentException - если параметр порта находится за пределами указанного диапазона допустимых значений порта, который составляет от 0 до 65535 включительно.
См. также:
SecurityManager.checkListen(int), ServerSocket(int, int, java.net.InetAddress)

© 1993, 2020, 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/11/docs/api/java.base/javax/net/ServerSocketFactory.html

Spec-Zone .ru
спецификации, руководства, описания, API