Класс ServerSocketFactory
- java.lang.Object
- javax.net.ServerSocketFactory
- Прямые известные подклассы:
SSLServerSocketFactory
public abstract class ServerSocketFactory extends Object
Этот класс создаёт сокеты сервера. Он может быть унаследован другими фабриками, которые создают определённые типы сокетов сервера. Это обеспечивает общий каркас для добавления публичных функциональных возможностей на уровне сокетов. Это аналог фабрики сокетов со стороны сервера, аналогично предоставляющий способ захвата различных политик, связанных с создаваемыми сокетами.
Как и фабрики сокетов, экземпляры ServerSocketFactory имеют методы, используемые для создания сокетов. Также существует условно-специфическая по умолчанию фабрика сокетов сервера; фреймворки часто используют свои собственные настраиваемые фабрики.
- С тех пор:
- 1.4
- См. также:
SocketFactory
Конструкторы
| Модификатор | Конструктор | Описание |
|---|---|---|
protected | ServerSocketFactory() | Создаёт фабрику сокетов сервера. |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
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()
Возвращает копию фабрики сокетов по умолчанию среды.
- Возвращает:
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