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

Методы, объявленные в классе java.lang.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()

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

Возвращает:: часть имени хоста адреса.

getHostString

public final String getHostString()

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

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

isUnresolved

public final boolean isUnresolved()

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

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

toString

public String toString()

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

Если адрес — IPv6-адрес, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/net/InetSocketAddress.html