Класс 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. Если эта попытка завершится неудачно, адрес будет помечен как неразрешённый.

Если присутствует менеджер безопасности, его метод checkConnect вызывается с именем хоста в качестве аргумента для проверки разрешения на его разрешение. Это может привести к SecurityException.

Параметры:

hostname - имя хоста

port - Номер порта

Исключения:

IllegalArgumentException - если параметр порта находится вне допустимого диапазона или если параметр имени хоста null.

SecurityException - если менеджер безопасности присутствует и разрешение на разрешение имени хоста отказано.

См. также:

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

createUnresolved

public static InetSocketAddress createUnresolved(String host, int port)

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

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

Параметры:

host - имя хоста

port - Номер порта

Возвращает:

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

Исключения:

IllegalArgumentException - если параметр порта находится вне допустимого диапазона или если параметр имени хоста null.

С:

1.5

См. также:

getPort

public final int getPort()

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

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

getAddress

public final InetAddress getAddress()

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

Возвращает:: InetAdress или 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-адрес, 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, 2023, 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/21/docs/api/java.base/java/net/InetSocketAddress.html