萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Java IPv4 與整數互轉核心原理與高效工具類實作

IPv4 地址與整數的數學本質

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)

核心工具類:IPv4Util

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 };
    }
}

關鍵技術點解析

1. 無號運算陷阱

Java 無無號整數類型。byte 為有號(-128~127),位運算前必須 & 0xFF 轉為正數 int。右移必須用 >>>>(邏輯右移,補 0),不可用 >>(算術右移,補符號位)。

2. InetAddress.getByName() vs 手動解析

方式優點缺點
InetAddress支援主機名解析、IPv6、系統快取可能觸發 DNS 查詢、較慢、拋出檢查型異常
手動解析極快、純運算、可自訂驗證邏輯不支援主機名、需自行處理 IPv6

3. CIDR 計算數學原理

  • 網路位址 = IP & 掩碼
  • 廣播位址 = IP | ~掩碼
  • 可用主機數 = 2^(32-prefix) - 2(排除網路位址與廣播位址)

單元測試驗證

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 12+:java.net.InetAddress 仍為標準,但可搭配 java.nio.channels.DatagramChannel 等 NIO API
  • 第三方庫:com.google.guava:guava 的 InetAddresses、org.apache.commons:commons-ip-math 提供更豐富的 IP 運算
  • IPv6:本工具類僅支援 IPv4,IPv6 需 128 位(Inet6Address、java.math.BigInteger)

總結

IP-整數互轉核心是大端序位運算。掌握 & 0xFF、>>>>、移位組合,即可寫出高效、正確的工具類。CIDR 範圍計算是防火牆規則、IP 分配、網路掃描的基礎運算。生產環境建議使用成熟庫減少造輪子風險。

copyright © 萬盛學電腦網 all rights reserved