Класс InetAddressResolver.LookupPolicy

java.lang.Object

java.net.spi.InetAddressResolver.LookupPolicy

Внешний интерфейс:: InetAddressResolver

public static final class InetAddressResolver.LookupPolicy extends Object

Объект LookupPolicy описывает характеристики, которые можно применить к операции поиска. В частности, он используется для указания порядка и фильтрации, которые следует выполнять при поиске адресов узла.

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

Начиная с:: 18

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`IPV4`	Значение характеристики, указывающее, нужно ли запрашивать адреса IPv4 при поиске.
`static final int`	`IPV4_FIRST`	Значение характеристики, указывающее, должны ли адреса IPv4 возвращаться первыми методом `InetAddressResolver`.
`static final int`	`IPV6`	Значение характеристики, указывающее, нужно ли запрашивать адреса IPv6 при поиске.
`static final int`	`IPV6_FIRST`	Значение характеристики, указывающее, должны ли адреса IPv6 возвращаться первыми методом `InetAddressResolver`.

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

Модификатор и тип	Метод	Описание
`int`	`characteristics()`	Возвращает набор характеристик этой политики поиска.
`static InetAddressResolver.LookupPolicy`	`of(int characteristics)`	Этот фабричный метод создает экземпляр `LookupPolicy` с заданным значением `characteristics`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и подлежит удалению в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

Подробное описание полей

IPV4

@Native public static final int IPV4

Значение характеристики, указывающее, нужно ли запрашивать адреса IPv4 при поиске.

См. также:

IPV6

@Native public static final int IPV6

Значение характеристики, указывающее, нужно ли запрашивать адреса IPv6 при поиске.

См. также:

IPV4_FIRST

@Native public static final int IPV4_FIRST

Значение характеристики, указывающее, должны ли адреса IPv4 возвращаться первыми методом InetAddressResolver.

См. также:

IPV6_FIRST

@Native public static final int IPV6_FIRST

Значение характеристики, указывающее, должны ли адреса IPv6 возвращаться первыми методом InetAddressResolver.

См. также:

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

of

public static InetAddressResolver.LookupPolicy of(int characteristics)

Этот фабричный метод создает экземпляр LookupPolicy с заданным значением characteristics.

Значение characteristics представляет собой целочисленную битовую маску, определяющую параметры операции прямого поиска. Эти параметры определяют как минимум:

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

Для запроса адресов определенных семейств можно объединить следующие битовые маски:

IPV4: для запроса адресов IPv4
IPV6: для запроса адресов IPv6

Если не задано ни IPV4, ни IPV6, возникает ошибка.

Для задания определенного порядка результатов:

IPV4_FIRST: возвращать адреса IPv4 перед любыми адресами IPv6
IPV6_FIRST: возвращать адреса IPv6 перед любыми адресами IPv4

Если не задано ни IPV4_FIRST, ни IPV6_FIRST, используется «системный» порядок адресов. Запрос одновременно IPV4_FIRST и IPV6_FIRST приводит к ошибке.

Параметры:

characteristics — значение, представляющее набор характеристик поиска

Возвращает:

экземпляр InetAddressResolver.LookupPolicy

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

IllegalArgumentException — если предоставлена недопустимая битовая маска характеристик

См. также:

characteristics

public int characteristics()

Возвращает набор характеристик этой политики поиска.

Возвращает:

значение характеристик

См. также:

© 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.