Java 網路程式設計精通指南（2）：InetAddress 四大靜態工廠方法 — 創建 IP 地址對象完全指南

InetAddress 無 public 構造器，必須通過 4 個靜態工廠方法創建實例。本文系統講解 getLocalHost、getByName、getAllByName、getByAddress 的參數、異常、返回值差異及適用場景。

方法總覽

1. getLocalHost() — 本機地址

InetAddress local = InetAddress.getLocalHost();
System.out.println(local); // 輸出: ComputerName/192.168.18.10 (toString 格式: hostName/IP)

toString() 實現：hostName + "/" + getHostAddress()。

多 IP 機器只返回第一個，需用 getAllByName(hostName) 獲取全部。

2. getByName(String host) — 單 IP 解析

// 域名
InetAddress addr = InetAddress.getByName("www.csdn.net"); // 返回第一個 IP
System.out.println(addr); // www.csdn.net/211.100.26.124

// 本機名
InetAddress addr2 = InetAddress.getByName("ComputerName"); // 等同 getLocalHost()

// localhost
InetAddress addr3 = InetAddress.getByName("localhost"); // 127.0.0.1

// hosts 文件映射 (C:\Windows\System32\drivers\etc\hosts)
// 192.168.18.100 www.mysite.com
InetAddress addr4 = InetAddress.getByName("www.mysite.com"); // www.mysite.com/192.168.18.100

// 直接傳 IP 字符串 (無 DNS 查詢，不驗證 IP 有效性)
InetAddress addr5 = InetAddress.getByName("129.42.58.212"); // /129.42.58.212 (hostName 為空)

3. getAllByName(String host) — 全量 IP 解析

InetAddress[] addrs = InetAddress.getAllByName("www.csdn.net");
for (InetAddress a : addrs) System.out.println(a);
// 輸出 4 個 IP:
// www.csdn.net/211.100.26.124
// www.csdn.net/211.100.26.121
// www.csdn.net/211.100.26.122
// www.csdn.net/211.100.26.123

關鍵發現：getByName(host) 內部實現即 getAllByName(host)[0]。

傳 IP 給 getAllByName

InetAddress[] addrs = InetAddress.getAllByName("211.100.26.122");
// 輸出單個: /211.100.26.122 (hostName 為空)

4. getByAddress(byte[] addr) — 純本地構造

**零網路開銷**，不驗證 IP 合法性/可達性，僅構造對象。數組長度必須為 4 (IPv4) 或 16 (IPv6)。

// 重載 1: 僅 IP 字節
byte[] ip = {(byte)141, (byte)146, 8, 66}; // 141.146.8.66
InetAddress addr1 = InetAddress.getByAddress(ip);
System.out.println(addr1); // /141.146.8.66

// 重載 2: 指定關聯主機名 (別名)
InetAddress addr2 = InetAddress.getByAddress("Oracle官方網站", ip);
System.out.println(addr2); // Oracle官方網站/141.146.8.66

第二重載的 host 參數**不觸發 DNS**，僅作為顯示別名存入對象。可傳任意字符串。

異常處理指南

• UnknownHostException：域名不存在、DNS 故障、getByAddress 數組長度非 4/16。
• 所有方法均拋出此檢查異常，必須 try-catch 或 throws。
• 傳 IP 字符串給 getByName/getAllByName **永不拋出** UnknownHostException (即使 IP 不存在)。

選擇指南