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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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 представляют один и тот же адрес, если совпадают InetAddresses (или имена узлов, если адрес не разрешён) и номера портов. Если оба адреса не разрешены, сравниваются имя узла и номер порта. Примечание: регистр символов в именах узлов не учитывается. Например, «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.