模块 java.base

包 java.net.spi

接口 InetAddressResolver

public interface InetAddressResolver
      

该接口定义了查找主机名和 IP 地址的操作。 InetAddress 将所有查找操作委托给系统范围的解析器.

这系统范围的解析器可以由 部署一个实现 的 部署一个实现 定制。

自从：

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 - 如果地址是 null