Интерфейс 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.

Parameters:

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

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

Returns:

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

Throws:

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

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

See Also:

lookupByAddress

String lookupByAddress(byte[] addr) throws UnknownHostException

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

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

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

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

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