Spec-Zone.ru › OpenJDK 8

Класс 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.

Spec-Zone.ru

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