Класс InetSocketAddress

java.lang.Object

java.net.SocketAddress

java.net.InetSocketAddress

Все реализуемые интерфейсы:: Serializable

public class InetSocketAddress extends SocketAddress

Этот класс реализует адрес IP-сокета (IP-адрес + номер порта). Это также может быть пара (имя хоста + номер порта); в этом случае будет предпринята попытка разрешить имя хоста. Если разрешение не удастся, адрес будет считаться неразрешённым, но в некоторых случаях его всё ещё можно использовать, например, для подключения через прокси-сервер.

Он предоставляет неизменяемый объект, используемый сокетами для привязки, подключения или в качестве возвращаемого значения.

Подстановочный адрес — это специальный локальный IP-адрес. Обычно он означает «любой» и может использоваться только для операций bind.

С момента версии:

1.4

См. также:

Краткое описание конструкторов

Конструктор	Описание
`InetSocketAddress(int port)`	Создаёт адрес сокета, в котором IP-адрес является подстановочным адресом, а номер порта — указанным значением.
`InetSocketAddress(String hostname, int port)`	Создаёт адрес сокета на основе имени хоста и номера порта.
`InetSocketAddress(InetAddress addr, int port)`	Создаёт адрес сокета на основе IP-адреса и номера порта.

Краткое описание методов

Модификатор и тип	Метод	Описание
`static InetSocketAddress`	`createUnresolved(String host, int port)`	Создаёт неразрешённый адрес сокета на основе имени хоста и номера порта.
`final boolean`	`equals(Object obj)`	Сравнивает этот объект с указанным объектом.
`final InetAddress`	`getAddress()`	Возвращает `InetAddress`.
`final String`	`getHostName()`	Возвращает `hostname`.
`final String`	`getHostString()`	Возвращает имя хоста или строковое представление адреса, если имя хоста отсутствует (адрес был создан с использованием литерала).
`final int`	`getPort()`	Возвращает номер порта.
`final int`	`hashCode()`	Возвращает хеш-код этого адреса сокета.
`final boolean`	`isUnresolved()`	Проверяет, разрешён ли адрес.
`String`	`toString()`	Создаёт строковое представление этого InetSocketAddress.

Методы, объявленные в классе Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

InetSocketAddress

public InetSocketAddress(int port)

Создаёт адрес сокета, в котором IP-адрес является подстановочным адресом, а номер порта — указанным значением.

Допустимое значение порта находится в диапазоне от 0 до 65535. Если указать номер порта zero, система выберет динамический порт для операции bind.

Параметры:: port — номер порта
Исключения:: IllegalArgumentException — если значение параметра порта выходит за указанный диапазон допустимых значений порта.

InetSocketAddress

public InetSocketAddress(InetAddress addr, int port)

Создаёт адрес сокета на основе IP-адреса и номера порта.

Адрес null задаёт подстановочный адрес.

Параметры:: addr — IP-адрес; port — номер порта
Исключения:: IllegalArgumentException — если значение параметра порта выходит за указанный диапазон допустимых значений порта.

InetSocketAddress

public InetSocketAddress(String hostname, int port)

Создаёт адрес сокета на основе имени хоста и номера порта.

Будет предпринята попытка преобразовать имя хоста в InetAddress. Если эта попытка не удастся, адрес будет помечен как неразрешённый.

Параметры:

hostname — имя хоста

port — номер порта

Исключения:

IllegalArgumentException — если значение параметра порта выходит за диапазон допустимых значений порта или если параметр имени хоста равен null.

См. также:

Подробное описание методов

createUnresolved

public static InetSocketAddress createUnresolved(String host, int port)

Создаёт неразрешённый адрес сокета на основе имени хоста и номера порта.

Попытка преобразовать имя хоста в InetAddress предприниматься не будет. Адрес будет помечен как неразрешённый.

Параметры:

host — имя хоста

port — номер порта

Возвращает:

InetSocketAddress, представляющий неразрешённый адрес сокета

Исключения:

С момента версии:

1.5

См. также:

getPort

public final int getPort()

Возвращает номер порта.

Возвращает:: номер порта.

getAddress

public final InetAddress getAddress()

Возвращает InetAddress.

Возвращает:: InetAddress или null, если адрес не разрешён.

getHostName

public final String getHostName()

Возвращает hostname. Примечание: если адрес был создан с использованием IP-адреса-литерала, этот метод может вызвать обратный поиск в службе имён.

Возвращает:: часть адреса, содержащую имя хоста.

getHostString

public final String getHostString()

Возвращает имя хоста или строковое представление адреса, если имя хоста отсутствует (адрес был создан с использованием литерала). Это позволяет не выполнять обратный поиск.

Возвращает:: имя хоста или строковое представление адреса.
С момента версии:: 1.7

isUnresolved

public final boolean isUnresolved()

Проверяет, разрешён ли адрес.

Возвращает:: true, если имя хоста не удалось преобразовать в InetAddress.

toString

public String toString()

Создаёт строковое представление этого InetSocketAddress. Эта строка создаётся путём вызова InetAddress.toString() для InetAddress и добавления номера порта (через двоеточие).

Если адрес является IPv6-адресом, его литерал заключается в квадратные скобки, например: "localhost/[0:0:0:0:0:0:0:1]:80". Если адрес неразрешён, вместо литерала адреса отображается <unresolved>, например "foo/<unresolved>:80".

Чтобы получить строковое представление имени хоста или адреса, используйте getHostString(), а не анализируйте строку, возвращаемую этим методом toString().

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого объекта.

equals

public final boolean equals(Object obj)

Сравнивает этот объект с указанным объектом. Результат равен true тогда и только тогда, когда аргумент не равен null и представляет тот же адрес, что и этот объект.

Два экземпляра InetSocketAddress представляют один и тот же адрес, если InetAddress (или имена хостов, если адреса не разрешены) и номера портов совпадают. Если оба адреса не разрешены, сравниваются имя хоста и номер порта. Примечание: имена хостов не учитывают регистр. Например, «FooBar» и «foobar» считаются равными.

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

equals в классе Object

Параметры:

obj — объект для сравнения.

Возвращает:

true, если объекты совпадают; в противном случае — false.

См. также:

hashCode

public final int hashCode()

Возвращает хеш-код этого адреса сокета.

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

hashCode в классе Object

Возвращает:

значение хеш-кода этого адреса сокета.

См. также:

© 1993, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/net/InetSocketAddress.html