Класс InetAddress

public class InetAddress
extends Object
implements Serializable

Этот класс представляет собой адрес Интернет-протокола (IP).

Адрес IP — это либо 32-битное, либо 128-битное беззнаковое число, используемое протоколом IP, более низкоуровневым протоколом, на котором строятся протоколы, такие как UDP и TCP. Архитектура адресов IP определена в RFC 790: Присвоенные номера, RFC 1918: Распределение адресов для частных сетей, RFC 2365: Администрируемый IP-мультипост и RFC 2373: Архитектура адресации IP версии 6. Экземпляр InetAddress состоит из адреса IP и, возможно, соответствующего имени хоста (в зависимости от того, был ли он создан с именем хоста или уже выполнена обратная резолюция имени хоста).

Типы адресов

unicast

Идентификатор одного интерфейса. Пакет, отправленный по адресу unicast, доставляется на интерфейс, идентифицированный этим адресом. Адрес "без указания" -- Также называется любым локальным или подстановочным адресом. Его никогда нельзя назначать никакому узлу. Он указывает на отсутствие адреса. Один пример его использования — в качестве целевого адреса bind, который позволяет серверу принимать подключение клиента на любом интерфейсе, если у узла сервера несколько интерфейсов. Адрес без указания не должен использоваться в качестве целевого адреса IP-пакета. Адреса обратной связи — это адрес, назначенный интерфейсу обратной связи. Всё, что отправляется по этому IP-адресу, возвращается и становится IP-входом на локальном узле. Этот адрес часто используется при тестировании клиента.

multicast

Идентификатор набора интерфейсов (обычно принадлежащих различным узлам). Пакет, отправленный по multicast-адресу, доставляется на все интерфейсы, идентифицированные этим адресом.

Сфера действия IP-адреса

Локальные адреса предназначены для использования для адресации на одном канале, например, для автоматической настройки адреса, обнаружения соседей или при отсутствии маршрутизаторов.

Локальные адреса сайта предназначены для использования для адресации внутри сайта без необходимости использования глобального префикса.

Глобальные адреса уникальны в Интернете.

Текстовое представление IP-адресов

Текстовое представление IP-адреса зависит от семейства адресов.

Для формата адресов IPv4 см. Inet4Address#format; для формата адресов IPv6 см. Inet6Address#format.

Существует несколько системных свойств, влияющих на использование адресов IPv4 и IPv6.

Резолюция имени хоста

Резолюция имени хоста в IP-адрес выполняется с помощью комбинации информации о конфигурации локальной машины и сетевых служб именования, таких как система доменных имён (DNS) и служба сетевой информации (NIS). Используемые службы именования по умолчанию — это конфигурированные на локальной машине. Для любого имени хоста возвращается соответствующий IP-адрес.

Обратная резолюция имени означает, что для любого IP-адреса возвращается хост, связанный с этим IP-адресом.

Класс InetAddress предоставляет методы для преобразования имён хостов в IP-адреса и наоборот.

Кэширование InetAddress

Класс InetAddress имеет кэш для хранения успешных и неуспешных резолюций имён хостов.

По умолчанию, при установке менеджера безопасности для защиты от атак подмены DNS, результаты успешных резолюций имён хостов кэшируются навсегда. При отсутствии менеджера безопасности поведение по умолчанию — кэшировать записи в течение конечного (зависимого от реализации) периода времени. Результат неудачной резолюции имени хоста кэшируется в течение очень короткого периода времени (10 секунд) для повышения производительности.

Если поведение по умолчанию нежелательно, можно установить системное свойство Java для изменения значения Time-to-live (TTL) для положительного кэширования. Аналогичным образом, системный администратор может настроить другое значение TTL негативного кэширования при необходимости.

Два системных свойства Java управляют значениями TTL, используемыми для кэширования положительных и отрицательных резолюций имени хоста:

networkaddress.cache.ttl

Указывает политику кэширования для успешных поисков имен в службе именования. Значение задаётся целым числом, указывающим количество секунд для кэширования успешного поиска. Значение по умолчанию — кэширование на период, зависящий от реализации.

Значение -1 означает "кэшировать навсегда".

networkaddress.cache.negative.ttl (по умолчанию: 10)

Указывает политику кэширования для неудачных поисков имен в службе именования. Значение задаётся целым числом, указывающим количество секунд для кэширования неудачи при неуспешных поисках.

Значение 0 означает "никогда не кэшировать". Значение -1 означает "кэшировать навсегда".

Методы

isMulticastAddress

public boolean isMulticastAddress()

Вспомогательная функция для проверки, является ли InetAddress адресом IP-мультиадресации.

Возвращает:

значение boolean, указывающее, является ли InetAddress адресом IP-мультиадресации

С тех пор:

JDK1.1

isAnyLocalAddress

public boolean isAnyLocalAddress()

Вспомогательная функция для проверки, является ли InetAddress универсальным адресом.

Возвращает:

значение boolean, указывающее, является ли InetAddress универсальным адресом.

С тех пор:

1.4

isLoopbackAddress

public boolean isLoopbackAddress()

Вспомогательная функция для проверки, является ли InetAddress адресом обратной связи.

Возвращает:

значение boolean, указывающее, является ли InetAddress адресом обратной связи; в противном случае — false.

С тех пор:

1.4

isLinkLocalAddress

public boolean isLinkLocalAddress()

Вспомогательная функция для проверки, является ли InetAddress адресом локальной сети.

Возвращает:

значение boolean, указывающее, является ли InetAddress адресом локальной сети; или false, если адрес не является одноадресным адресом локальной сети.

С тех пор:

1.4

isSiteLocalAddress

public boolean isSiteLocalAddress()

Вспомогательная функция для проверки, является ли InetAddress адресом локальной сети.

Возвращает:

значение boolean, указывающее, является ли InetAddress адресом локальной сети; или false, если адрес не является одноадресным адресом локальной сети.

С тех пор:

1.4

isMCGlobal

public boolean isMCGlobal()

Вспомогательная функция для проверки, имеет ли адрес мультиадресации глобальный охват.

Возвращает:

значение boolean, указывающее, является ли адрес адресом мультиадресации с глобальным охватом, false, если адрес не имеет глобального охвата или не является адресом мультиадресации.

С тех пор:

1.4

isMCNodeLocal

public boolean isMCNodeLocal()

Вспомогательная функция для проверки, имеет ли адрес мультиадресации охват узла.

Возвращает:

значение boolean, указывающее, является ли адрес адресом мультиадресации с охватом узла, false, если адрес не имеет охвата узла или не является адресом мультиадресации

С тех пор:

1.4

isMCLinkLocal

public boolean isMCLinkLocal()

Вспомогательная функция для проверки, имеет ли адрес мультиадресации охват ссылки.

Возвращает:

значение boolean, указывающее, является ли адрес адресом мультиадресации с охватом локальной сети, false, если адрес не имеет охвата локальной сети или не является адресом мультиадресации

С тех пор:

1.4

isMCSiteLocal

public boolean isMCSiteLocal()

Вспомогательная функция для проверки, имеет ли адрес мультиадресации охват сайта.

Возвращает:

значение boolean, указывающее, является ли адрес адресом мультиадресации с охватом сайта, false, если адрес не имеет охвата сайта или не является адресом мультиадресации

С тех пор:

1.4

isMCOrgLocal

public boolean isMCOrgLocal()

Вспомогательная функция для проверки, имеет ли адрес мультиадресации охват организации.

Возвращает:

значение boolean, указывающее, является ли адрес адресом мультиадресации с охватом организации, false, если адрес не имеет охвата организации или не является адресом мультиадресации

С тех пор:

1.4

isReachable

public boolean isReachable(int timeout)
                    throws IOException

Параметры:

timeout - время в миллисекундах, до которого вызов будет прерван

Возвращает:

значение boolean, указывающее, доступен ли адрес.

Исключения:

IOException - если произошла сетевая ошибка

IllegalArgumentException - если timeout отрицательно.

С тех пор:

1.5

isReachable

public boolean isReachable(NetworkInterface netif,
                           int ttl,
                           int timeout)
                    throws IOException

Параметры:

netif - сетевой интерфейс, через который будет выполняться проверка, или null для любого интерфейса

ttl - максимальное количество переходов или 0 для значения по умолчанию

timeout - время в миллисекундах, до которого вызов будет прерван

Возвращает:

значение boolean, указывающее, доступен ли адрес.

Исключения:

IllegalArgumentException - если timeout или ttl отрицательные.

IOException - если произошла сетевая ошибка

С тех пор:

1.5

getHostName

public String getHostName()

Возвращает:

имя хоста для этого IP-адреса или, если операция не разрешена проверкой безопасности, текстовое представление IP-адреса.

См. также:

getCanonicalHostName(), SecurityManager.checkConnect(java.lang.String, int)

getCanonicalHostName

public String getCanonicalHostName()

Возвращает:

полное доменное имя для этого IP-адреса или, если операция не разрешена проверкой безопасности, текстовое представление IP-адреса.

С тех пор:

1.4

См. также:

SecurityManager.checkConnect(java.lang.String, int)

getAddress

public byte[] getAddress()

Возвращает исходный IP-адрес этого объекта InetAddress. Результат представлен в сетевом порядке байтов: старший байт адреса находится в getAddress()[0].

Возвращает:

исходный IP-адрес этого объекта.

getHostAddress

public String getHostAddress()

Возвращает строковое представление IP-адреса.

Возвращает:

строковое представление исходного IP-адреса.

С тех пор:

JDK1.0.2

hashCode

public int hashCode()

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

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

hashCode в классе Object

Возвращает:

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

См. также:

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

equals

public boolean equals(Object obj)

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

getAddress()

toString

public String toString()

Преобразует этот IP-адрес в String. Возвращаемая строка имеет вид: имя_хоста / литерный IP-адрес. Если имя хоста не разрешено, поиск обратного имени службы не выполняется. Часть имени хоста будет представлена пустой строкой.

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

toString в классе Object

Возвращает:

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

getByAddress

public static InetAddress getByAddress(String host,
                                       byte[] addr)
                                throws UnknownHostException

Параметры:

host - указанный хост

addr - сырой IP-адрес в сетевом порядке байтов

Возвращает:

объект InetAddress, созданный из сырого IP-адреса.

Выбрасывает:

UnknownHostException - если IP-адрес имеет неправильную длину

С:

1.4

getByName

public static InetAddress getByName(String host)
                             throws UnknownHostException

Параметры:

host - указанный хост или null.

Возвращает:

IP-адрес для данного имени хоста.

Выбрасывает:

UnknownHostException - если IP-адрес для host не найден или если для глобального IPv6 адреса был указан идентификатор области действия.

SecurityException - если менеджер безопасности существует и его метод checkConnect не разрешает операцию.

getAllByName

public static InetAddress[] getAllByName(String host)
                                  throws UnknownHostException

Параметры:

host - имя хоста или null.

Возвращает:

массив всех IP-адресов для данного имени хоста.

Выбрасывает:

UnknownHostException - если IP-адрес для host не найден или если для глобального IPv6 адреса был указан идентификатор области действия.

SecurityException - если менеджер безопасности существует и его метод checkConnect не разрешает операцию.

См. также:

SecurityManager.checkConnect(java.lang.String, int)

getLoopbackAddress

public static InetAddress getLoopbackAddress()

Возвращает:

экземпляр InetAddress петли обратной связи.

С:

1.7

getByAddress

public static InetAddress getByAddress(byte[] addr)
                                throws UnknownHostException

Параметры:

addr - сырой IP-адрес в сетевом порядке байтов

Возвращает:

объект InetAddress, созданный из сырого IP-адреса.

Выбрасывает:

UnknownHostException - если IP-адрес имеет неправильную длину

С:

1.4

getLocalHost

public static InetAddress getLocalHost()
                                throws UnknownHostException

Возвращает:

адрес локального хоста.

Выбрасывает:

UnknownHostException - если имя локального хоста не удалось преобразовать в адрес.

См. также:

SecurityManager.checkConnect(java.lang.String, int), getByName(java.lang.String)