Java-API简析_java.net.InetAddress类（基于 Latest JDK）（浅析源码）

【版权声明】未经博主同意，谢绝转载！（请尊重原创，博主保留追究权）
https://blog.csdn.net/m0_69908381/article/details/131590559
出自【进步*于辰的博客】

注：
1、派生类1：Inet4Address类；
2、派生类2：Inet6Address类；
3、衍生类：InetSocketAddress类。

1、概述

继承关系：

• java.lang.Object
  • java.net.InetAddress

所有已实现的接口：
Serializable
直接已知子类：
Inet4Address、Inet6Address

---

public class InetAddress extends Object implements Serializable

此类表示互联网协议 (IP) 地址。

IP 地址是 IP 使用的 32 位或 128 位$无符号数字$，它是一种低级协议，UDP 和 TCP 协议都是在它的基础上构建的。IP 地址的体系结构是由 RFC 790:Assigned Numbers、 RFC 1918:Address Allocation for Private Internets、RFC 2365:Administratively Scoped IP Multicast 和 RFC 2373:IP Version 6 Addressing Architecture 定义。InetAddress 的实例包含 IP 地址，还可能包含相应的主机名（取决于它是否用主机名构造或者是否已执行反向主机名解析）。

地址类型

单播

单个接口的标识符。发送到单播地址的数据包被交付给由该地址标识的接口。

多播地址：也称为 anylocal 地址或 通配符地址。 一定不能将其分配给任何节点。它指示缺少地址。它的一个使用示例是可以作为绑定的目标，这允许服务器在服务器主机有多个接口的情况下接收任何接口上的客户端连接。

未 指定 地址一定不能用作 IP 数据包的目标地址。

回送 地址：它是分配给回送接口的地址。发送到此 IP 地址的任何内容都将返回并作为本地主机上的 IP 输入。此地址常常在测试客户机时使用。

多播

一组接口（通常属于不同的节点）的标识符。发送到多播地址的数据包被交付给由该地址标识的所有接口。

IP 地址范围

链接本地 地址设计用于在单个链接上寻址以解决诸如自动地址配置、邻居发现 (neighbor discovery) 或没有路由器时的问题。

站点本地 地址设计用于在不需要全球前缀时站点内部寻址。

全球 地址在 Internet 中是唯一的。

IP 地址的文本表示形式

IP 地址的文本表示形式是特定于地址系列的。
有关 IPv4 地址格式，请参阅 Inet4Address#format，有关 IPv6 地址格式，请参阅 Inet6Address#format。

主机名解析

主机名到 IP 地址的解析 通过使用本地机器配置信息和网络命名服务（如域名系统（Domain Name System，DNS）和网络信息服务（Network Information Service，NIS））来实现。要使用的特定命名服务默认情况下是本地机器配置的那个。对于任何主机名称，都返回其相应的 IP 地址。

反向名称解析 意味着对于任何 IP 地址，都返回与 IP 地址关联的主机。

InetAddress 类提供将主机名解析为其 IP 地址（或反之）的方法。

InetAddress 缓存

InetAddress 类具有一个存储成功及不成功主机名解析的缓存。正缓存用于防止 DNS 哄骗攻击；而负缓存用于提高性能。
默认情况下，正主机名解析的结果会永远缓存，因为不存在何时可以安全移除缓存条目的一般规则。不成功主机名解析的结果缓存非常短的时间（10 秒）以提高性能。

在某些特定情形下，即可以确定不可能发生 DNS 哄骗攻击时，可以将 Java 安全属性设置为另外的 Time-to-live (TTL) 值来进行正缓存。类似地，系统管理员在需要时可以配置另外的负缓存 TTL 值。

两个 Java 安全属性控制着用于正负主机名解析缓存的 TTL 值：

networkaddress.cache.ttl（默认值：-1）

指示从名称服务进行成功名称查找的缓存策略。该值被指定为整数，指示缓存成功查找的秒数。

值 -1 指示“永远缓存”。

networkaddress.cache.negative.ttl（默认值：10）

指示从名称服务进行不成功名称查找的缓存策略。该值被指定为整数，指示缓存不成功查找故障的秒数。

值 0 指示“永远不缓存”。值 -1 指示“永远缓存”。

$注：$
此类是 IP 地址的基础类，一些功能需要具体版本的 IP 地址才能实现。因此，在此类的源码中，大家会看到很多方法的底层没有任何代码或业务，具体源码需查阅此类的两个派生类。
换言之，具体功能是通过两个派生类实现的。至于底层是如何实现调用的，经过对源码的解析，我判断是通过此类的实现类 SocketImpl 间接调用来实现。

从以下版本开始：
JDK1.0
另请参见：
getByAddress(byte[])、getByAddress(java.lang.String, byte[])、getAllByName(java.lang.String)、getByName(java.lang.String)、getLocalHost()、序列化表格

2、方法摘要

2.1 boolean equals(Object obj)

将此对象与指定对象比较。
说明：
先看源码。

注译：

1. 将obj与当前实例进行比较，当且仅当obj != null，且两者所代表的ip地址相同时，返回 true；
2. ip相同条件：2个实例通过调用getAddress()（见下1项）获取的byte[]的长度和成分（内容）相同。

---

为何源码无任何业务，直接返回 false，暂未可知。

2.2 byte[] getAddress()

返回此 InetAddress 对象的原始 IP 地址。
说明：
先看源码。

具体实现可查阅派生类1的第2.2项。

2.3 static InetAddress[] getAllByName(String host)

在给定主机名的情况下，根据系统上配置的名称服务 返回其 IP 地址所组成的数组。
说明：
先看源码。

底层调用第5.1项。

示例：

InetAddress[] arr1= InetAddress.getAllByName("localhost");
sout Arrays.toString(arr1);// 打印：[localhost/127.0.0.1, localhost/0:0:0:0:0:0:0:1]
InetAddress[] arr2 = InetAddress.getAllByName("");
sout Arrays.toString(arr2);// 打印：[localhost/127.0.0.1]

2.4 static InetAddress getByAddress(byte[] addr)

在给定原始 IP 地址的情况下，返回 InetAddress 对象。
说明：
先看源码。

底层调用下1项。

2.5 static InetAddress getByAddress(String host, byte[] addr)

根据提供的主机名和 IP 地址创建 InetAddress。
说明：
看源码。

2.6 static InetAddress getByName(String host)

在给定主机名的情况下确定主机的 IP 地址。
说明：
先看源码。

底层调用第3项。

示例：

InetAddress ip1 = InetAddress.getByName("localhost");
System.out.println(ip1);
System.out.println(ip1.getCanonicalHostName());
System.out.println(ip1.getHostAddress());
System.out.println(ip1.getHostName());

打印结果：

2.7 String getCanonicalHostName()

获取此 IP 地址的完全限定域名。

2.8 String getHostAddress()

返回 IP 地址字符串（以文本表现形式）。
说明：
先看源码。

具体实现可查阅派生类1的第2.3项。

2.9 String getHostName()

获取此 IP 地址的主机名。
说明：
先看源码。

指定：

true表示进行安全检查。

---

底层调用第5.7项。

2.10 static InetAddress getLocalHost()

返回本地主机。
示例：

InetAddress lp = InetAddress.getLocalHost();
System.out.println(lp);
System.out.println(lp.getCanonicalHostName());
System.out.println(lp.getHostAddress());
System.out.println(lp.getHostName());

打印结果：

2.11 int hashCode()

返回此 IP 地址的哈希码。
说明：
先看源码。

具体实现可查阅派生类1的第2.4项。

2.12 boolean isAnyLocalAddress()

检查 InetAddress 是否是$通配符地址$的实用例行程序。
说明：
先看源码。

具体实现可查阅派生类1的第2.5项。

2.13 boolean isLinkLocalAddress()

检查 InetAddress 是否是$链接本地地址$的实用例行程序。
说明：
看源码。

具体实现可查阅派生类1的第2.6项。

2.14 boolean isLoopbackAddress()

检查 InetAddress 是否是回送地址 的实用例行程序。
说明：
看源码。

具体实现可查阅派生类1的第2.7项。

示例：

InetAddress ip = InetAddress.getByName("localhost");
sout ip.isAnyLocalAddress();// 打印：false
sout ip.isLinkLocalAddress();// 打印：false
sout ip.isLoopbackAddress();// 打印：true

为何本地 ip（"localhost"）属于$回送地址$，暂未可知。

2.15 boolean isMCGlobal()

检查多播地址是否具有全球范围的实用例行程序。

2.16 boolean isMCLinkLocal()

检查多播地址是否具有链接范围的实用例行程序。

2.17 boolean isMCNodeLocal()

检查多播地址是否具有节点范围的实用例行程序。

2.18 boolean isMCOrgLocal()

检查多播地址是否具有组织范围的实用例行程序。

2.19 boolean isMCSiteLocal()

检查多播地址是否具有站点范围的实用例行程序。

2.20 boolean isMulticastAddress()

检查 InetAddress 是否是 IP 多播地址的实用例行程序。

2.21 boolean isReachable(int timeout)

测试是否可以达到该地址。

2.22 boolean isReachable(NetworkInterface netif, int ttl, int timeout)

测试是否可以达到该地址。

2.23 boolean isSiteLocalAddress()

检查 InetAddress 是否是站点本地地址的实用例行程序。

2.24 String toString()

将此 IP 地址转换为 String。

3、关于嵌套类InetAddressHolder

InetAddress 类的基本信息类。
说明：
先看源码。

可见，此类是 InetAddress 类的$静态内部类$，用于封装 ip 地址的基本信息，包括：

1. originalHostName→ 原始主机名，便于基于域的端点识别（暂未知）；
2. hostName→ 主机名；
3. address→ ip 地址（为何是int类型，暂未知）；
4. family→ 类型，1表示 IPv4，2表示 IPv6。

4、构造方法摘要（不开放）

4.1 null

构造一个默认基本信息的 IP 地址。
说明：
先看源码。

关于new，见第3项。

5、方法摘要（不开放）

5.1 private static InetAddress[] getAllByName(String host, InetAddress reqAddr)

在给定主机名和 IP 地址的情况下，根据系统上配置的名称服务 返回其 IP 地址所组成的数组。
说明：
先看源码。

后续解析。

5.2 private static InetAddress[] getAllByName0 (String host)

在给定主机名的情况下，根据系统上配置的名称服务 返回其 IP 地址所组成的数组。
说明：
先看源码。

指定：

true表示进行安全检查。

---

底层调用下1项。

5.3 static InetAddress[] getAllByName0 (String host, boolean check)

在给定主机名和是否进行安全检查的情况下，根据系统上配置的名称服务 返回其 IP 地址所组成的数组。
说明：
先看源码。

底层调用下1项。

5.4 private static InetAddress[] getAllByName0 (String host, InetAddress reqAddr, boolean check)

在给定主机名、IP地址和是否进行安全检查的情况下，根据系统上配置的名称服务 返回其 IP 地址所组成的数组。
说明：
先看源码。

关于checkConnect()，见SecurityManager类的第4.5项。

后续补充解析。

5.5 static InetAddress anyLocalAddress()

返回代表anyLocalAddress的 IP 地址。
说明：
先看源码。

impl的类型是 InetAddressImpl，这是此类相关功能实现类的接口，此接口的2个实现类分别是Inet4AddressImpl和Inet6AddressImpl。
因此，所调用的是 Inet4AddressImpl 类的anyLocalAddress()，见派生类1的第4.1项。

5.6 InetAddressHolder holder()

返回嵌套类 InetAddressHolder 的实例。
说明：
看源码。

5.7 String getHostName(boolean check)

获取此 IP 地址的主机名。
说明：
先看源码。

后续解析。

最后

如果大家需要Java-API文档，我上传了《Java-API文档-包含5/8/11三个版本》。

---

本文暂缓更新。