IPv4 位址是 32 位元無號整數,習慣用點分十進制表示(如 192.168.1.1)。轉換核心是位元組順序(大端序/Network Byte Order)與位運算的結合。
IP: 192 . 168 . 1 . 1
└─┬─┘ └─┬─┘ └┬┘ └┬┘
│ │ │ └─ 第 4 組:最低 8 位元
│ │ └───── 第 3 組:第 8-15 位元
│ └────────── 第 2 組:第 16-23 位元
└──────────────── 第 1 組:最高 8 位元 (符號位需注意)
整數 = (第1組 << 24) | (第2組 << 16) | (第3組 << 8) | 第4組
= (192 << 24) | (168 << 16) | (1 << 8) | 1
= 3232235777 (無號) / -1062731519 (Java 有號 int)
package michael.utils;
import java.net.InetAddress;
import java.net.UnknownHostException;
public final class IPv4Util {
private static final int INADDRSZ = 4;
private IPv4Util() {} // 工具類
// ========== IP → byte[] ==========
/** 使用 InetAddress 解析(支援主機名、IPv6 兼容) */
public static byte[] ipToBytesByInet(String ipAddr) {
try {
return InetAddress.getByName(ipAddr).getAddress();
} catch (UnknownHostException e) {
throw new IllegalArgumentException(ipAddr + " is invalid IP", e);
}
}
/** 手動解析(效能更高,無 DNS 解析開銷) */
public static byte[] ipToBytesByReg(String ipAddr) {
String[] parts = ipAddr.split("\\."); // 注意轉義
if (parts.length != 4) {
throw new IllegalArgumentException("Invalid IPv4 format: " + ipAddr);
}
byte[] ret = new byte[4];
try {
for (int i = 0; i < 4; i++) {
int val = Integer.parseInt(parts[i]);
if (val < 0 || val > 255) throw new NumberFormatException();
ret[i] = (byte) (val & 0xFF);
}
return ret;
} catch (NumberFormatException e) {
throw new IllegalArgumentException("Invalid octet in IP: " + ipAddr, e);
}
}
// ========== byte[] → IP 字串 ==========
public static String bytesToIp(byte[] bytes) {
if (bytes == null || bytes.length != 4) {
throw new IllegalArgumentException("Need 4 bytes");
}
return new StringBuilder()
.append(bytes[0] & 0xFF).append('.')
.append(bytes[1] & 0xFF).append('.')
.append(bytes[2] & 0xFF).append('.')
.append(bytes[3] & 0xFF)
.toString();
}
// ========== byte[] ↔ int (大端序) ==========
/** byte[][4] → int (大端序) */
public static int bytesToInt(byte[] bytes) {
if (bytes == null || bytes.length != 4) {
throw new IllegalArgumentException("Need 4 bytes");
}
// 使用 & 0xFF 將 byte 視為無號處理
return ((bytes[0] & 0xFF) << 24) |
((bytes[1] & 0xFF) << 16) |
((bytes[2] & 0xFF) << 8) |
(bytes[3] & 0xFF);
}
/** int → byte[][4] (大端序) */
public static byte[] intToBytes(int ipInt) {
return new byte[] {
(byte) ((ipInt >>> 24) & 0xFF),
(byte) ((ipInt >>> 16) & 0xFF),
(byte) ((ipInt >>> 8) & 0xFF),
(byte) (ipInt & 0xFF)
};
}
// ========== 高層 API ==========
/** IP 字串 → int */
public static int ipToInt(String ipAddr) {
return bytesToInt(ipToBytesByReg(ipAddr)); // 手動解析更快
}
/** int → IP 字串 */
public static String intToIp(int ipInt) {
return new StringBuilder()
.append((ipInt >>> 24) & 0xFF).append('.')
.append((ipInt >>> 16) & 0xFF).append('.')
.append((ipInt >>> 8) & 0xFF).append('.')
.append(ipInt & 0xFF)
.toString();
}
// ========== CIDR 範圍計算 ==========
/**
* 計算 CIDR 網段範圍
* @param cidr 如 "192.168.1.0/24"
* @return [網路地址int, 廣播地址int]
*/
public static int[] getIPIntScope(String cidr) {
String[] parts = cidr.split("/");
if (parts.length != 2) {
throw new IllegalArgumentException("Invalid CIDR: " + cidr);
}
int ipInt = ipToInt(parts[0]);
int prefixLen = Integer.parseInt(parts[1].trim());
if (prefixLen < 0 || prefixLen > 32) {
throw new IllegalArgumentException("Invalid prefix length: " + prefixLen);
}
// 網路遮罩:前 prefixLen 位為 1
int netMask = (prefixLen == 0) ? 0 : (0xFFFFFFFF << (32 - prefixLen));
int netIP = ipInt & netMask;
int hostScope = (prefixLen == 32) ? 0 : (0xFFFFFFFF >>> prefixLen);
int broadcastIP = netIP | hostScope;
return new int[] { netIP, broadcastIP };
}
/**
* 取得 CIDR 範圍的字串表示
*/
public static String[] getIPAddrScope(String cidr) {
int[] range = getIPIntScope(cidr);
return new String[] { intToIp(range[0]), intToIp(range[1]) };
}
// ========== 子網掩碼格式支援 ==========
/**
* IP + 子網掩碼 計算範圍
* @param ipAddr IP 位址
* @param mask 子網掩碼(如 255.255.255.0)或 CIDR 前綴長度(如 "24")
*/
public static int[] getIPIntScope(String ipAddr, String mask) {
int ipInt = ipToInt(ipAddr);
int netMaskInt;
if (mask == null || mask.isEmpty()) {
return new int[] { ipInt, ipInt };
}
// 判斷是 CIDR 前綴長度還是完整掩碼
if (mask.contains(".")) {
netMaskInt = ipToInt(mask);
} else {
int prefix = Integer.parseInt(mask);
if (prefix < 0 || prefix > 32) {
throw new IllegalArgumentException("Invalid prefix: " + prefix);
}
netMaskInt = (prefix == 0) ? 0 : (0xFFFFFFFF << (32 - prefix));
}
int netIP = ipInt & netMaskInt;
int hostScope = ~netMaskInt & 0xFFFFFFFF; // 主機位全 1
int broadcastIP = netIP | hostScope;
return new int[] { netIP, broadcastIP };
}
}
Java 無無號整數類型。byte 為有號(-128~127),位運算前必須 & 0xFF 轉為正數 int。右移必須用 >>>>(邏輯右移,補 0),不可用 >>(算術右移,補符號位)。
| 方式 | 優點 | 缺點 |
|---|---|---|
| InetAddress | 支援主機名解析、IPv6、系統快取 | 可能觸發 DNS 查詢、較慢、拋出檢查型異常 |
| 手動解析 | 極快、純運算、可自訂驗證邏輯 | 不支援主機名、需自行處理 IPv6 |
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
class IPv4UtilTest {
@Test void testIpToInt() {
assertEquals(0xC0A80101, IPv4Util.ipToInt("192.168.1.1"));
assertEquals(0x7F000001, IPv4Util.ipToInt("127.0.0.1"));
assertEquals(0xFFFFFFFF, IPv4Util.ipToInt("255.255.255.255"));
}
@Test void testIntToIp() {
assertEquals("192.168.1.1", IPv4Util.intToIp(0xC0A80101));
assertEquals("0.0.0.0", IPv4Util.intToIp(0));
}
@Test void testCIDR() {
int[] range = IPv4Util.getIPIntScope("192.168.1.0/24");
assertEquals(IPv4Util.ipToInt("192.168.1.0"), range[0]);
assertEquals(IPv4Util.ipToInt("192.168.1.255"), range[1]);
}
@Test void testMask() {
int[] range = IPv4Util.getIPIntScope("192.168.1.100", "255.255.255.0");
assertEquals(IPv4Util.ipToInt("192.168.1.0"), range[0]);
assertEquals(IPv4Util.ipToInt("192.168.1.255"), range[1]);
}
}
java.net.InetAddress 仍為標準,但可搭配 java.nio.channels.DatagramChannel 等 NIO APIcom.google.guava:guava 的 InetAddresses、org.apache.commons:commons-ip-math 提供更豐富的 IP 運算Inet6Address、java.math.BigInteger)IP-整數互轉核心是大端序位運算。掌握 & 0xFF、>>>>、移位組合,即可寫出高效、正確的工具類。CIDR 範圍計算是防火牆規則、IP 分配、網路掃描的基礎運算。生產環境建議使用成熟庫減少造輪子風險。