Класс InetSocketAddress

java.lang.Object
- java.net.SocketAddress
- - java.net.InetSocketAddress

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

public class InetSocketAddress
extends SocketAddress

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

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

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

С:: 1.4
См. также:: Socket, ServerSocket, Сериализованная форма

Конструкторы

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

Методы

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

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

Адрес null назначит универсальный адрес.

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

InetSocketAddress

public InetSocketAddress(String hostname,
                         int port)

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

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

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

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

Параметры:: hostname - имя хоста; port - Номер порта
Исключения:: IllegalArgumentException - если параметр порта находится вне диапазона допустимых значений портов или если параметр имени хоста null.; SecurityException - если присутствует менеджер безопасности и разрешение на разрешение имени хоста отклонено.
См. также:: isUnresolved()

Методы

createUnresolved

public static InetSocketAddress createUnresolved(String host,
                                                 int port)

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

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

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

Параметры:: host - имя хоста; port - Номер порта
Возвращает:: объект InetSocketAddress, представляющий неразрешённый адрес сокета
Исключения:: IllegalArgumentException - если параметр порта находится вне диапазона допустимых значений портов или если параметр имени хоста null.
С:: 1.5
См. также:: isUnresolved()

getPort

Получает номер порта.

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

getAddress

Получает IP-адрес.

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

getHostName

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

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

getHostString

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

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

isUnresolved

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

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

toString

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

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

equals

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

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

Переопределяет:: equals(Object) в классе Object
Параметры:: obj - объект для сравнения.
Возвращает:: true, если объекты одинаковые; false в противном случае.
См. также:: equals(Object)

hashCode

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

Переопределяет:: hashCode() в классе Object
Возвращает:: значение хэш-кода для этого адреса сокета.
См. также:: equals(Object), identityHashCode(Object)