Класс 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()
Возвращает копию фабрики сокета по умолчанию среды.
- Возвращает:
- 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, 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.