Spec-Zone.ru › OpenJDK 25

Интерфейс InetAddressResolver

public interface InetAddressResolver
Этот интерфейс определяет операции поиска имен хостов и IP-адресов. InetAddress делегирует все операции поиска системному резолверу.

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

Начиная с:
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-адрес
См. также:
  • InetAddressResolver.LookupPolicy

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

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/net/spi/InetAddressResolver.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API