Интерфейс InetAddressResolver

public interface InetAddressResolver

Данный интерфейс определяет операции для поиска имен хостов и IP-адресов. InetAddress делегирует все операции поиска глобальному решателю.

Глобальный решатель можно настроить, разместив реализацию InetAddressResolverProvider.

Since:: 18

Краткое описание вложенных классов

Модификатор и тип	Интерфейс	Описание
`static final class`	`InetAddressResolver.LookupPolicy`	Объект `LookupPolicy` описывает характеристики, которые можно применить к операции поиска.

Краткое описание методов

Модификатор и тип	Метод	Описание
`String`	`lookupByAddress(byte[] addr)`	Поиск имени хоста, соответствующего предоставленному IP-адресу в сыром виде.
`Stream<InetAddress>`	`lookupByName(String host, InetAddressResolver.LookupPolicy lookupPolicy)`	Принимая имя хоста, возвращает поток IP-адресов запрошенной семейства адресов, связанных с предоставленным именем хоста.

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

lookupByName

Stream<InetAddress> lookupByName(String host, InetAddressResolver.LookupPolicy lookupPolicy) throws UnknownHostException

Принимая имя хоста, возвращает поток IP-адресов запрошенной семейства адресов, связанных с предоставленным именем хоста.

host должно быть именем машины, например, "www.example.com", а не текстовым представлением её IP-адреса. Никакой валидации на предоставленное host имя не выполняется: если предоставлено текстовое представление, разрешение имени, скорее всего, завершится ошибкой, и может быть выброшено исключение UnknownHostException.

Тип семейства адресов и порядок адресов задаются экземпляром LookupPolicy. Характеристики операции поиска можно получить с помощью InetAddressResolver.LookupPolicy.characteristics(). Если указаны характеристики InetAddressResolver.LookupPolicy.IPV4 и InetAddressResolver.LookupPolicy.IPV6, то данный метод возвращает адреса семейств IPV4 и IPV6.

Параметры:

host - указанное имя хоста

lookupPolicy - политика поиска адресов

Возвращает:

поток IP-адресов для запрошенного хоста

Исключение:

NullPointerException - если любой из параметров null

UnknownHostException - если для host не удалось найти IP-адрес

См. также:

lookupByAddress

String lookupByAddress(byte[] addr) throws UnknownHostException

Поиск имени хоста, соответствующего предоставленному IP-адресу в сыром виде.

addr аргумент находится в сетевом порядке байтов: старший байт адреса находится в addr[0].

Массив байтов для IPv4 адреса должен иметь длину 4 байта, а для IPv6 - 16 байтов.

Параметры:: addr - массив байтов, представляющий сырой IP-адрес
Возвращает:: String, представляющий отображение имени хоста
Исключение:: UnknownHostException - если для указанного IP-адреса не найдено имя хоста; IllegalArgumentException - если длина предоставленного массива байтов не соответствует длине валидного IP-адреса; NullPointerException - если addr null

© 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/spi/InetAddressResolver.html