Класс 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 того же типа: выбрасывается IOException, если Socket использует пользовательскую SocketImpl. Экземпляр этого класса, использующий пользовательскую 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)

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