Module java.base

Package java.net.spi

Class InetAddressResolver.LookupPolicy

java.lang.Object

java.net.spi.InetAddressResolver.LookupPolicy

封闭接口:

InetAddressResolver

       public static final class InetAddressResolver.LookupPolicy extends Object
      

一个LookupPolicy对象描述了可以应用于查找操作的特征。特别是，它用于指定在查找主机地址时应执行的排序和过滤方式。

默认的平台范围查找策略是通过查询影响IPv4和IPv6地址返回方式的系统属性来构建的。

自 JDK 版本:

18

Field Summary

Fields

Modifier and Type	Field	Description
static final int	IPV4	表示是否在查找过程中需要查询IPv4地址的特征值。
static final int	IPV4_FIRST	表示是否应该首先返回IPv4地址的特征值，由InetAddressResolver确定。
static final int	IPV6	表示是否在查找过程中需要查询IPv6地址的特征值。
static final int	IPV6_FIRST	表示是否应该首先返回IPv6地址的特征值，由InetAddressResolver确定。

Method Summary

Modifier and Type	Method	Description
int	characteristics()	返回此查找策略的特征集。
static InetAddressResolver.LookupPolicy	of(int characteristics)	此工厂方法使用给定的characteristics值创建一个LookupPolicy实例。

Methods declared in class java.lang.Object

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

Field Details

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确定。

参见:

• 常量字段值

Method Details

of

             public static InetAddressResolver.LookupPolicy of(int characteristics)
            

此工厂方法使用给定的characteristics值创建一个LookupPolicy实例。

characteristics值是一个整数位掩码，定义了前向查找操作的参数。这些参数至少定义了：

• 返回地址的地址族类型
• 解析器实现应返回其结果的顺序

要请求特定地址族类型的地址，可以组合以下位掩码：

• IPV4：请求IPv4地址
• IPV6：请求IPv6地址

如果既未设置IPV4也未设置IPV6，则会出错。

要请求特定结果的特定顺序：

• IPV4_FIRST：在任何IPv6地址之前返回IPv4地址
• IPV6_FIRST：在任何IPv4地址之前返回IPv6地址

如果既未设置IPV4_FIRST也未设置IPV6_FIRST，则意味着地址的“系统”顺序。请求同时设置IPV4_FIRST和IPV6_FIRST会出错。

参数:

characteristics - 表示查找特征集的值

返回:

InetAddressResolver.LookupPolicy的一个实例

抛出:

IllegalArgumentException - 如果提供了非法的特征位掩码

参见:

• InetAddressResolver.lookupByName(String, LookupPolicy)

characteristics

             public int characteristics()
            

返回此查找策略的特征集。

返回:

一个特征值

参见:

• InetAddressResolver.lookupByName(String, LookupPolicy)