Класс InetAddressResolver.LookupPolicy

java.lang.Object

java.net.spi.InetAddressResolver.LookupPolicy

Enclosing interface:: InetAddressResolver

public static final class InetAddressResolver.LookupPolicy extends Object

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

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

Since:: 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`.

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

См. также:

IPV6_FIRST

@Native public static final int IPV6_FIRST

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

См. также:

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

of

public static InetAddressResolver.LookupPolicy of(int characteristics)

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

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

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

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

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