Класс InetAddressResolver.LookupPolicy

java.lang.Object

java.net.spi.InetAddressResolver.LookupPolicy

Enclosing interface:: InetAddressResolver

public static final class InetAddressResolver.LookupPolicy extends Object

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

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

Since:: 18

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

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

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

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

Методы, унаследованные от класса java.lang.Object

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

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

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 должны возвращаться первыми при поиске адресов по последовательности .

См. также:

IPV6_FIRST

@Native public static final int IPV6_FIRST

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

См. также:

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

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.

Parameters:

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

Returns:

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

Throws:

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

См. также:

characteristics

public int characteristics()

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

Returns:

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

См. также:

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