Класс ServerSocket

Создаёт сокет сервера, привязанный к указанному порту. Значение порта 0 означает, что номер порта автоматически выделяется, обычно из диапазона временных портов. Этот номер порта можно получить, вызвав getLocalPort.

Максимальная длина очереди для входящих указаний на подключение (запрос на подключение) установлена в 50. Если указание на подключение приходит, когда очередь полная, подключение отклоняется.

Если приложение указало фабрику сокетов сервера, метод createSocketImpl этой фабрики вызывается для создания фактической реализации сокета. В противном случае создаётся "обычный" сокет.

Если есть менеджер безопасности, его метод checkListen вызывается с аргументом port, чтобы убедиться, что операция разрешена. Это может привести к SecurityException.

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

Максимальная длина очереди для входящих указаний на подключение (запрос на подключение) установлена в параметр backlog. Если указание на подключение приходит, когда очередь полная, подключение отклоняется.

Если приложение указало фабрику сокетов сервера, метод createSocketImpl этой фабрики вызывается для создания фактической реализации сокета. В противном случае создаётся "обычный" сокет.

Если есть менеджер безопасности, его метод checkListen вызывается с аргументом port для обеспечения разрешения операции. Это может привести к SecurityException. Аргумент backlog - это запрашиваемая максимальная длина очереди ожидающих подключений к сокету. Точное значение зависит от реализации. В частности, реализация может установить максимальную длину или вообще игнорировать параметр. Предоставленное значение должно быть больше 0. Если оно меньше или равно 0, будет использоваться реализационно-зависимое значение по умолчанию.

Создаёт сервер с указанным портом, длиной очереди ожидающих подключений и локальным IP-адресом для привязки. Аргумент bindAddr может использоваться на многоадресном хосте для ServerSocket, который будет принимать запросы на подключение только к одному из его адресов. Если bindAddr равен null, то сокет будет принимать подключения к любому/всем локальным адресам. Порт должен быть в диапазоне от 0 до 65535 включительно. Значение порта 0 означает, что номер порта автоматически выделяется, обычно из диапазона временных портов. Этот номер порта можно получить, вызвав getLocalPort.

Если есть менеджер безопасности, этот метод вызывает его метод checkListen с аргументом port для обеспечения разрешения операции. Это может привести к SecurityException. Аргумент backlog - это запрашиваемая максимальная длина очереди ожидающих подключений к сокету. Точное значение зависит от реализации. В частности, реализация может установить максимальную длину или вообще игнорировать параметр. Предоставленное значение должно быть больше 0. Если оно меньше или равно 0, будет использоваться реализационно-зависимое значение по умолчанию.

Привязывает ServerSocket к конкретному адресу (IP-адрес и номер порта).

Если адрес null, система выберет временный порт и допустимый локальный адрес для привязки сокета.

Привязывает ServerSocket к конкретному адресу (IP-адрес и номер порта).

Если адрес null, система выберет временный порт и допустимый локальный адрес для привязки сокета.

Аргумент backlog - это запрашиваемая максимальная длина очереди ожидающих подключений к сокету. Точное значение зависит от реализации. В частности, реализация может установить максимальную длину или вообще игнорировать параметр. Предоставленное значение должно быть больше 0. Если оно меньше или равно 0, будет использоваться реализационно-зависимое значение по умолчанию.

Возвращает локальный адрес этого сокета сервера.

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

Если установлен менеджер безопасности, его метод checkConnect вызывается с локальным адресом и -1 в качестве аргументов для проверки разрешения операции. Если операция не разрешена, возвращается адрес loopback.

Возвращает номер порта, на котором прослушивает этот сокет.

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

Возвращает адрес конечной точки, к которой привязан этот сокет.

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

Если установлен менеджер безопасности, его метод checkConnect вызывается с локальным адресом и -1 в качестве аргументов для проверки разрешения операции. Если операция не разрешена, возвращается SocketAddress представляющий адрес loopback и локальный порт, к которому привязан сокет.

Ожидает подключения к этому сокету и принимает его. Метод блокируется до тех пор, пока не будет установлено подключение.

Создается новый сокет s, и если существует менеджер безопасности, вызывается его метод checkAccept с s.getInetAddress().getHostAddress() и s.getPort() в качестве аргументов для проверки разрешения операции. Это может привести к исключению SecurityException.

Закрывает этот сокет. Любой поток, заблокированный в accept(), выбросит исключение SocketException.

Если этому сокету связан канал, то канал также закрывается.

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

У серверного сокета будет канал, только если сам канал был создан с помощью метода ServerSocketChannel.open.

Включает/отключает опцию сокета SO_REUSEADDR.

При закрытии TCP-соединения соединение может оставаться в состоянии таймаута в течение определённого периода после закрытия (обычно это состояние TIME_WAIT или состояние ожидания 2MSL). Для приложений, использующих известный адрес сокета или порт, может быть невозможно привязать сокет к требуемому SocketAddress, если существует соединение в состоянии таймаута, связанное с адресом сокета или портом.

Включение SO_REUSEADDR перед привязкой сокета с помощью bind(SocketAddress) позволяет привязать сокет, даже если предыдущее соединение находится в состоянии таймаута.

При создании ServerSocket начальное значение SO_REUSEADDR не определено. Приложения могут использовать getReuseAddress() для определения начального значения SO_REUSEADDR.

Поведение при включении или отключении SO_REUSEADDR после привязки сокета (см. isBound()) не определено.

Возвращает адрес и порт реализации этого сокета в виде String.

Если установлен менеджер безопасности, вызывается его метод checkConnect с локальным адресом и -1 в качестве аргументов, чтобы проверить разрешение операции. Если операция не разрешена, возвращается объект InetAddress , представляющий адрес loopback.

Устанавливает фабрику реализации серверного сокета для приложения. Фабрику можно указать только один раз.

Когда приложение создаёт новый серверный сокет, вызывается метод фабрики реализации сокета createSocketImpl для создания фактической реализации сокета.

Передача null в метод является пустой операцией, если фабрика ещё не была установлена.

Если существует менеджер безопасности, этот метод сначала вызывает метод менеджера безопасности checkSetFactory для проверки разрешения операции. Это может привести к исключению SecurityException.

Устанавливает значение по умолчанию для параметра SO_RCVBUF для сокетов, принятых от этого ServerSocket. Фактическое значение, установленное в принятом сокете, должно быть определено вызовом Socket.getReceiveBufferSize() после того, как сокет будет возвращён методом accept().

Значение параметра SO_RCVBUF используется для установки размера внутреннего буфера приема сокета и размера TCP-окна приема, рекламируемого удалённому узлу.

Возможна последующая смена значения, вызывая Socket.setReceiveBufferSize(int). Однако, если приложение хочет разрешить окно приема, большее 64К байт, как определено в RFC1323, то предложенное значение должно быть установлено в ServerSocket до привязки к локальному адресу. Это подразумевает, что ServerSocket должен быть создан с конструктором без аргументов, затем вызывается setReceiveBufferSize(), а затем ServerSocket привязывается к адресу с помощью bind().

Отсутствие выполнения этих шагов не приведёт к ошибке, и размер буфера может быть установлен до запрошенного значения, но TCP-окно приема в сокетах, принятых от этого ServerSocket, будет не больше 64К байт.

Получает значение параметра SO_RCVBUF для этого ServerSocket, то есть предложенный размер буфера, который будет использован для сокетов, принятых от этого ServerSocket.

Обратите внимание, что фактическое значение, установленное в принятом сокете, определяется вызовом Socket.getReceiveBufferSize().

Устанавливает параметры производительности для данного ServerSocket.

Сокеты по умолчанию используют протокол TCP/IP. Некоторые реализации могут предложить альтернативные протоколы с другими характеристиками производительности, чем TCP/IP. Этот метод позволяет приложению выразить свои предпочтения относительно того, как эти компромиссы должны быть сделаны, когда реализация выбирает из доступных протоколов.

Параметры производительности описываются тремя целыми числами, значения которых указывают на относительную важность короткого времени соединения, низкой задержки и высокой пропускной способности. Абсолютные значения целых чисел не имеют значения; для выбора протокола значения просто сравниваются, причём более высокие значения указывают на более сильные предпочтения. Например, если приложение предпочитает короткое время соединения перед низкой задержкой и высокой пропускной способностью, то оно может вызвать этот метод со значениями (1, 0, 0). Если приложение предпочитает высокую пропускную способность перед низкой задержкой, а низкую задержку перед коротким временем соединения, то оно может вызвать этот метод со значениями (0, 1, 2).

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