Класс InetSocketAddress

public class InetSocketAddress
extends SocketAddress

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

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

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

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

InetSocketAddress

public InetSocketAddress(int port)

Параметры:

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

Исключения:

IllegalArgumentException - если значение параметра порта находится за пределами указанного диапазона допустимых значений порта.

InetSocketAddress

public InetSocketAddress(InetAddress addr,
                         int port)

Параметры:

addr - IP-адрес

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

Исключения:

IllegalArgumentException - если значение параметра порта находится за пределами указанного диапазона допустимых значений порта.

InetSocketAddress

public InetSocketAddress(String hostname,
                         int port)

Параметры:

hostname - имя хоста

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

Исключения:

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

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

См. также:

isUnresolved()

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

createUnresolved

public static InetSocketAddress createUnresolved(String host,
                                                 int port)

Параметры:

host - имя хоста

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

Возвращает:

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

Исключения:

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

С тех пор:

1.5

См. также:

isUnresolved()

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. Эта строка создаётся путём вызова toString() для InetAddress и конкатенации номера порта (с двоеточием). Если адрес неразрешён, то часть перед двоеточием будет содержать только имя хоста.

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

toString в классе Object

Возвращает:

строковое представление этого объекта.

equals

public final boolean equals(Object obj)

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

InetAddress.equals(java.lang.Object)

hashCode

public final int hashCode()

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

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

hashCode в классе Object

Возвращает:

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

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)