Класс ServerSocket

protected ServerSocket(SocketImpl impl)

Параметры:

impl — экземпляр SocketImpl, используемый в ServerSocket.

Исключения:

NullPointerException — если impl равен null.

Начиная с:

12

public ServerSocket() throws IOException

Исключения:

IOException — ошибка ввода-вывода при открытии сокета.

public ServerSocket(int port) throws IOException

Параметры:

port — номер порта или 0, если нужно использовать номер порта, назначаемый автоматически.

Исключения:

IOException — если при открытии сокета возникает ошибка ввода-вывода.

IllegalArgumentException — если параметр порта находится вне указанного диапазона допустимых значений портов от 0 до 65535 включительно.

public ServerSocket(int port, int backlog) throws IOException

Параметры:

port — номер порта или 0, если нужно использовать номер порта, назначаемый автоматически.

backlog — запрошенная максимальная длина очереди входящих соединений.

Исключения:

IOException — если при открытии сокета возникает ошибка ввода-вывода.

IllegalArgumentException — если параметр порта находится вне указанного диапазона допустимых значений портов от 0 до 65535 включительно.

public ServerSocket(int port, int backlog, InetAddress bindAddr) throws IOException

Параметры:

port — номер порта или 0, если нужно использовать номер порта, назначаемый автоматически.

backlog — запрошенная максимальная длина очереди входящих соединений.

bindAddr — локальный InetAddress, с которым будет связан сервер

Исключения:

IOException — если при открытии сокета возникает ошибка ввода-вывода.

IllegalArgumentException — если параметр порта находится вне указанного диапазона допустимых значений портов от 0 до 65535 включительно.

Начиная с:

1.1

public void bind(SocketAddress endpoint) throws IOException

Параметры:

endpoint — IP-адрес и номер порта для привязки.

Исключения:

IOException — если операция привязки завершается с ошибкой, сокет уже связан или закрыт.

IllegalArgumentException — если endpoint является подклассом SocketAddress, который не поддерживается этим сокетом

Начиная с:

1.4

public void bind(SocketAddress endpoint, int backlog) throws IOException

Параметры:

endpoint — IP-адрес и номер порта для привязки.

backlog — запрошенная максимальная длина очереди входящих соединений.

Исключения:

IOException — если операция привязки завершается с ошибкой, сокет уже связан или закрыт.

IllegalArgumentException — если endpoint является подклассом SocketAddress, который не поддерживается этим сокетом

Начиная с:

1.4

public InetAddress getInetAddress()

Возвращает:

адрес, с которым связан этот сокет, или null, если сокет не связан.

public int getLocalPort()

Возвращает:

номер порта, на котором этот сокет ожидает подключения, или -1, если сокет еще не связан.

public SocketAddress getLocalSocketAddress()

Возвращает:

SocketAddress, представляющий локальную конечную точку этого сокета, или null, если сокет еще не связан.

Начиная с:

1.4

См. также:

• getInetAddress()
• getLocalPort()
• bind(SocketAddress)

public Socket accept() throws IOException

Примечание по реализации:

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

Возвращает:

новый Socket

Исключения:

IOException — если при ожидании подключения возникает ошибка ввода-вывода, сокет не связан или закрыт.

SocketTimeoutException — если ранее был задан тайм-аут с помощью setSoTimeout и он истек.

IllegalBlockingModeException — если с этим сокетом связан канал, канал работает в неблокирующем режиме и нет готового к приему соединения

protected final void implAccept(Socket s) throws IOException

Примечание по реализации:

Экземпляр этого класса, использующий системную реализацию SocketImpl по умолчанию, может принять соединение с Socket, использующим SocketImpl того же типа: если Socket использует пользовательскую реализацию SocketImpl, выбрасывается IOException. Экземпляр этого класса, использующий пользовательскую реализацию SocketImpl, не может принять соединение с Socket, использующим системную реализацию SocketImpl по умолчанию.

Параметры:

s — Socket

Исключения:

IllegalBlockingModeException — если с этим сокетом связан канал, работающий в неблокирующем режиме

IOException — если при ожидании подключения возникает ошибка ввода-вывода или если этот сокет не может принять соединение с переданным сокетом

Начиная с:

1.1

public void close() throws IOException

Определено в:

close в интерфейсе AutoCloseable

Определено в:

close в интерфейсе Closeable

Исключения:

IOException — если при закрытии сокета возникает ошибка ввода-вывода.

public ServerSocketChannel getChannel()

Возвращает:

канал серверного сокета, связанный с этим сокетом, или null, если этот сокет был создан не для канала

Начиная с:

1.4

public boolean isBound()

Возвращает:

true, если ServerSocket успешно связан с адресом

Начиная с:

1.4

public boolean isClosed()

Возвращает:

true, если сокет закрыт

Начиная с:

1.4

public void setSoTimeout(int timeout) throws SocketException

Параметры:

timeout — заданный тайм-аут в миллисекундах

Исключения:

SocketException — если в нижележащем протоколе произошла ошибка, например ошибка TCP, или сокет закрыт.

IllegalArgumentException — если timeout отрицательно

Начиная с:

1.1

См. также:

• getSoTimeout()

public int getSoTimeout() throws IOException

Возвращает:

значение SO_TIMEOUT

Исключения:

IOException — если возникает ошибка ввода-вывода или сокет закрыт.

Начиная с:

1.1

См. также:

• setSoTimeout(int)

public void setReuseAddress(boolean on) throws SocketException

Параметры:

on — включить или отключить параметр сокета

Исключения:

SocketException — если при включении или отключении параметра сокета SO_REUSEADDR возникает ошибка или сокет закрыт.

Начиная с:

1.4

См. также:

• getReuseAddress()
• bind(SocketAddress)
• isBound()
• isClosed()

public boolean getReuseAddress() throws SocketException

Возвращает:

значение типа boolean, указывающее, включен ли параметр SO_REUSEADDR.

Исключения:

SocketException — если в нижележащем протоколе произошла ошибка, например ошибка TCP, или сокет закрыт.

Начиная с:

1.4

См. также:

• setReuseAddress(boolean)

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

строковое представление этого сокета.

@Deprecated(since="17") public static void setSocketFactory(SocketImplFactory fac) throws IOException

Параметры:

fac — требуемая фабрика.

Исключения:

IOException — если при задании фабрики сокетов возникает ошибка ввода-вывода.

SocketException — если фабрика уже задана.

См. также:

• SocketImplFactory.createSocketImpl()

public void setReceiveBufferSize(int size) throws SocketException

Параметры:

size — размер буфера приема. Это значение должно быть больше 0.

Исключения:

SocketException — если в нижележащем протоколе произошла ошибка, например ошибка TCP, или сокет закрыт.

IllegalArgumentException — если значение равно 0 или отрицательно.

Начиная с:

1.4

См. также:

• getReceiveBufferSize()

public int getReceiveBufferSize() throws SocketException

Возвращает:

значение параметра SO_RCVBUF для этого Socket.

Исключения:

SocketException — если в нижележащем протоколе произошла ошибка, например ошибка TCP, или сокет закрыт.

Начиная с:

1.4

См. также:

• setReceiveBufferSize(int)

@Deprecated(since="26", forRemoval=true) public void setPerformancePreferences(int connectionTime, int latency, int bandwidth)

Параметры:

connectionTime — int, выражающее относительную важность малого времени установления соединения

latency — int, выражающее относительную важность низкой задержки

bandwidth — int, выражающее относительную важность высокой пропускной способности

Начиная с:

1.5

public <T> ServerSocket setOption(SocketOption<T> name, T value) throws IOException

Параметры типа:

T — тип значения параметра сокета

Параметры:

name — параметр сокета

value — значение параметра сокета. Для некоторых параметров допустимо значение null.

Возвращает:

этот ServerSocket

Исключения:

UnsupportedOperationException — если серверный сокет не поддерживает этот параметр.

IllegalArgumentException — если значение недопустимо для этого параметра.

IOException — если возникает ошибка ввода-вывода или сокет закрыт.

NullPointerException — если name равен null

Начиная с:

9

public <T> T getOption(SocketOption<T> name) throws IOException

Параметры типа:

T — тип значения параметра сокета

Параметры:

name — параметр сокета

Возвращает:

Значение параметра сокета.

Исключения:

UnsupportedOperationException — если серверный сокет не поддерживает этот параметр.

IOException — если возникает ошибка ввода-вывода или сокет закрыт.

NullPointerException — если name равен null

Начиная с:

9

public Set<SocketOption<?>> supportedOptions()

Возвращает:

Набор параметров сокета, поддерживаемых этим сокетом. Этот набор может быть пустым, если не удаётся создать SocketImpl сокета.

Начиная с:

9